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ARexx, das Amiga-Gegenstiick zur IBM-Programmiersprache 
REXX, ermoglicht Ihnen die individuelle Gestaltung Ihrer- 
Arbeitsumgebung. ARexx eignet sich besonders gut fur Skripts, 
uber die Anwendungen gesteuert und modifiziert sowie deren 
Interaktion mit anderen Anwendungen definiert werden. 

Das vorliegende Handbuch bietet eine Einfuhrung in ARexx, 
beschreibt das Erstellen von ARexx-Programmen und enthalt 
Referenzinformationen zu ARexx-Kommandos. 

Kapitel 1. Einfuhrung in ARexx: Dieses Kapitel bietet einen 
Uberblick uber ARexx, die Funktionsweise der Programmiersprache 
auf einem Amiga und die wichtigsten Funktionen der Program- 
miersprache. 

Kapitel 2. Erste Schritte: Hier wird beschrieben, wo ARexx- 
Programme zu speichern sind und wie ein ARexx-Programm 
aufgerufen wird. AuBerdem werden einige Programmierbeispiele 
vorgestellt. 

Kapitel 3. Elemente von ARexx: Dieses Kapitel beschreibt 
detailliert die Regeln und Konzepte, auf denen die Programmier- 
sprache ARexx basiert. 

Kapitel 4. Befehle: Dieses Kapitel enthalt eine alphabetische Liste 
der ARexx-Befehle. Darunter versteht man Sprachanweisungen zur 
Steuerung von Aktionen. 

Kapitel 5. Funktionen: Dieses Kapitel beschreibt die Verwendung 
von Funktionen (von ARexx verwendete Programmanweisungen) 
und enthalt eine alphabetische Liste der integrierten ARexx- 
Funktionen. 
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Kapitel 6. Testhilfe: Dieses Kapitel beschreibt die Funktionen der 
Fehlersuchhilfe auf Quelltextebene (source-level debugging), die bei 
der Entwicklung und beim Testen von Programmen eingesetzt 
werden kbnnen. 

Kapitel 7. Syntaxanalyse: Dieses Kapitel beschreibt, wie Informa- 
tionsmuster aus Zeichenfolgen extrahiert werden kbnnen. 

Anhang A. Fehlermeldungen: Dieser Anhang enthalt eine Liste 
der AEexx-Fehlermeldungen. 

Anhang B. Kommandohilfsprogramme: Dieser Anhang enthalt 
eine Liste der ARexx-Kommandos, die von der Shell aus aufgerufen 
werden kbnnen. 

Glossar. Das Glossar enthalt gebrauchliche ARexx-Begriffe und die 
dazugehorigen Definitionen. 



Dokumentkonventionen 

Im vorliegenden Handbuch gelten folgende Konventionen: 

SCHLUSSELWORTER Schlusselwbrter erscheinen stets in 

GroBbuchstaben; bei den Argumenten 
wird allerdings Grofl- und Kleinschrei- 
bung verwendet. 

ausdruck Erforderliche Argumente erscheinen in 

Kleinbuchstaben. 

I (senkrechter Strich) Alternative Auswahlmoglichkeiten wer- 

den durch senkrechte Striche vonein- 
ander getrennt. 

{ } (geschweifte Klammern) Erforderliche Alternativen stehen in 

geschweiften Klammern. 

[ ] (eckige Klammern) Wahlfreie Bestandteile eines Befehls 

stehen in eckigen Klammern. 
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IX 



<n> 



Courier 



Taste 1 - Taste2 



Taste 1, Taste2 



Amiga-Tasten 



Variablen stehen in spitzen Klammern. 
Diese spitzen Klammern durfen bei 
Eingabe von Variablen nicht mit einge- 
geben werden. 

Text in der Schriftart Courier stellt 
Ausgabe von ARexx-Programmen oder 
andere auf dem Monitor angezeigte In- 
formationen dar. 

Tastenkombinationen mit Bindestrich 
(-) bedeuten das gleichzeitige Driicken 
der jeweiligen Tasten. 

Tastenkombinationen mit Komma (,) 
als Trennzeichen bedeuten, dafl die 
Tasten nacheinander zu driicken sind. 

Zwei Tasten auf der Amiga-Tastatur 
dienen zur Ausfuhrung von Sonder- 
funktionen. Die linke Amiga- 
Sondertaste befindet sich links von der 
Leertaste und tragt ein grofies, schwarz 
ausgefulltes A. Die rechte Amiga- 
Sondertaste befindet sich rechts von 
der Leertaste und tragt ein grofies, im 
Umrifi gezeichnetes A. 
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Zusatzliche Informationsquellen 

Die folgenden Bucher enthalten weitere Informationen zum 
Erlernen und Verwenden von ARexx: 

Modern Programming Using REXX, by R.P. O'Hara and D.G. 
Gomberg, Prentice-Hall, 1985 

The REXX Language: A Practical Approach to Programming, by M. 
F. Cowlishaw, Prentice-Hall, 1985. Auch in Deutsch verfugbar als 
"Die Programmiersprache REXX". 

Programming in REXX, J. Ranade IBM Series, by Charles Daney. 

Using ARexx on the Amigg, by Chris Zamar^ and Nick Sullivan, 
Abacus, 1991. 

Amiga ROM Kernel Reference Manual: Libraries, Third Edition, 
Addison- Wesley, 1992. 
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Einfuhrung in ARexx 



Die Programmiersprache ARexx dient als zentraler Knotenpunkt, 
iiber den Anwendungen — auch solche anderer Hersteller — Daten 
und Kommandos untereinander austauschen konnen. Mit ARexx ist 
es beispielsweise moglich, ein Telekommunikationspaket so zusam- 
menzustellen, dafl es einen elektronischen Briefkasten ("Mailbox") 
anwahlt, die gewiinschten finanztechnischen Daten dort abruft und 
speichert und diese dann automatisch, d. h. ohne Eingreifen des 
Benutzers, in ein separates Tabellenkalkulationsprogramm iiber- 
tragt, um sie dort auszuwerten. 

ARexx ist eine interpretierende Sprache, die ASCII-Dateien als 
Eingabe verwendet. Der ARexx-Interpreter ist das Programm 
RexxMast. Dieses befindet sich in der Schublade "System" der 
Workbench. RexxMast iiberwacht die Ausfuhrung eines ARexx- 
Programms. Wenn RexxMast beim Ubersetzen oder Ausfuhren 
einer Zeile auf einen Fehler stoBt, wird der Programmablauf 
unterbrochen und eine Fehlermeldung angezeigt. Dieses interaktive 
Testen ist einerseits eine Lernhilfe, andererseits erleichtert es clie 
Programmerstellung bzw. -korrektur, da fjie Fehlermeljiung 
unmittelbar mitteilt, an welcher Stelle der Fehler aufgetreten ist. 
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1. 1 An welche Zielgruppe wendet 
sich ARexx? 

ARexx-Programme und -Skripts setzen keine detaillierten Kennt- 
nisse iiber den Amiga voraus, allerdings sollten Sie iiber Grund- 
kenntnisse iiber folgende Punkte verfugen: 

Offnen einer Shell und Eingeben von AmigaDOS-Befehlen 

• Verwenden eines Texteditors, z. B. ED oder MEmacs 

• Erstellen einer Benutzer-Startdatei 

Bevor Sie daran gehen konnen, Skripts zu verandern oder eigene 
ARexx-Skripts zu erstellen, sollten Sie die Grundlagen der 
Arbeitsumgebungen der Amiga-Workbench und von AmigaDOS 
kennen. Erfahrene Amiga-Benutzer werden feststellen, daB es sich 
mit ARexx leichter und effizienter arbeiten lafit als mit AmigaDOS. 
ARexx kann auch eingesetzt werden, um bereits bestehende 
AmigaDOS-Befehle und -Skripts zu erweitern oder zu ersetzen 
sowie integrierte Anwendungen zu erstellen. 



1.2 ARexx auf dem Amiga 



ARexx wird auf alien Amiga-Hardwarekonfigurationen unterstiitzt. 
Seit der Freigabe der Amiga Workbench Version 2.0 ist ARexx 
integraler Bestandteil des Amiga-Betriebssystems. ARexx verwen- 
det insbesondere zwei wichtige Funktionen des Amiga-Betriebs- 
systems: Multitasking und ProzeBkommunikation. 

Multitasking ist die Fahigkeit, gleichzeitig mehrere Programme 
auszufuhren. Sie konnen z. B. zur selben Zeit eine Datei edieren, 
eine Diskette formatieren und die Farben Ihres Monitors neu 
einstellen. 
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Unter ProzeBkommunikation (engl. Interprocess Communication - 
IPC) versteht man die Fahigkeit eines Computers, Informationen 
zwischen den gerade laufenden Anwendungen auszutauschen. Die 
ProzeBkommunikation wird iiber sogenannte Message-Ports (dt. 
etwa Nachrichtenschnittstellen) abgewickelt. Ein Message-Port ist 
eine in einem Anwendungsprogramm enthaltene Adresse, iiber die 
Nachrichten und Kommandos gesendet und empfangen werden 
konnen. Jeder Message-Port tragt einen Namen, und die 
Ubertragung einer Nachricht an eine Anwendung erfordert die 
Angabe des jeweiligen Port-Namens in einem ARexx-Skript. 

Die Operationen beim Senden und Empfangen von Nachrichten 
fmden in folgender Reihenfolge statt: 

1. Bei der Initialisierung offnet ein Anwendungsprogramm einen 
Message-Port. 

2. Die Anwendung wartet auf den Empfang einer Nachricht. 

3. Das Amiga-Betriebssystem teilt der Anwendung mit, daB eine 
Nachricht eingetroffen ist. 

4. Die Anwendung fuhrt eine der Nachricht entsprechende Aktion 
aus. 

5. Die Anwendung teilt dem Absender der Nachricht (ARexx) mit, 
daB die Nachricht empfangen und verarbeitet wurde. 

Diese Art der Naqhrichtenlibertragung ist nicht auf eine Anwen- 
dung und ARexx btgrenzt. Mehrere Anwendungen konnen Nach- 
richten tiber ARexx &ls zentrale Ubertragungsstation senden, emp- 
fangen und austauschgn. Natiirlich miissen alle beteiligten 
Anwendungsprogramme zu ARexx kompatibel sein. 
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1.3 Merkmale von ARexx 

Die Programmiersprache ARexx zeichnet sich durch folgende 
Merkmale aus: 

• Typenlose Daten — Daten werden als individuelle 
Zeichenfolgen behandelt, Variablenwerte werden nicht 
deklariert. 

• Interpretierte Ausfuhrung — Die Fahigkeit von ARexx, ein Pro- 
gramm direkt zu lesen und auszufuhren, macht ein separates 
Kompilieren des Programms uberflussig. 

• Automatische Betriebsmittelverwaltung — Dank der automa- 
tischen internen Speicherreservierung werden nicht mehr 
benotigte Zeichenfolgen und Daten entfernt. 

• Ablauf- und Ereignisverfolgung und Fehlersuche — Die Ablauf- 
verfolgung bzw. Ereignisverfolgung ermoglicht eine spezielle 
Fehlerbehandlung, wo ansonsten ein Programmabbruch die 
Folge ware. Die Testhilfefunktionen ermoglichen die Uberprii- 
fung des gesamten Programms, was den Zeitaufwand fur Ent- 
wicklung und Test reduziert. 

• Funktionsbibliotheken — Externe Funktionsbibliotheken 
enthal-ten erweiterte, vorprogrammierte Funktionen. 
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Erste Schritte 



In diesem Kapitel werden folgende Aktionen beschrieben: 

• Starten von ARexx 

• Sichern von Programmen 

• Speichern von Programmen 

• Verwenden von Beispielprogrammen 

2. 1 Starten von ARexx 

Zum Arbeiten mit ARexx wird zunachst das Programm RexxMast 
aktiviert. Dies kann automatisch oder manuell erfolgen. Bei jedem 
Starten oder Stoppen von ARexx wird eine Meldung angezeigt. 

2. 7. 1 Automatisches Starten von ARexx 

ARexx konnen Sie auf zwei Arten automatisch starten: indem Sie 
das Piktogramm RexxMast in die Schublade WBStartup ziehen oder 
die Datei S: User-Startup (Benutzer-Startdatei) edieren. 

Gehen Sie wie folgt vor, um das RexxMast-Piktogramm in die 
Schublade WBStartup zu ziehen: 

1. Offhen Sie die System-Schublade. 

2. Ziehen Sie das RexxMast-Piktogramm iiber die Schublade 
WBStartup. 

3. Starten Sie Ihren Amiga neu. 
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Gehen Sie wie folgt vor, urn die Datei S:User-Startup zu edieren: 

1. Offnen Sie einen Texteditor. 

2. Laden Sie die Datei S:User-Startup. 

3. Fiigen Sie dort folgende Zeile ein: REXXMAST>NIL:. 

4. Speichern Sie die Datei. 

5. Starten Sie Ihren Amiga neu. 

2.1.2 Manuelles Starten von ARexx 

Es gibt zwei Moglichkeiten, RexxMast manuell zu starten: Doppel- 
klicken auf das RexxMast-Piktogramm oder Starten des Programms 
von einer Shell aus. Benutzer von reinen Diskettensystemen 
konnen Speicherplatz sparen, indem sie ARexx nur bei Bedarf 

starten. 

Gehen Sie wie folgt vor, um RexxMast von der Workbench aus zu 
starten: 

1. Offnen Sie die System-Schublade. 

2. Doppelklicken Sie auf das RexxMast-Piktogramm. 
Zum Starten von RexxMast von der Shell aus: 

1. Offnen Sie eine Shell. 

2, Geben Sie REXXMAST >NIL: ein und drucken Si© die 
Eingabetaste. 
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2.2 Informationen zu ARexx- 
Programmen 

ARexx-Programme werden in der Regel im Verzeichnis REXX: 
gespeichert (dieses ist normalerweise dem Verzeichnis SYS:S 
zugewiesen). Es ware zwar moglich, Programme in beliebigen 
Verzeichnissen zu speichern; die Speicherung im Verzeichnis 
REXX: hat aber einige Vorteile: 

• Das Programm kann ohne Angabe des vollstandigen 
Pfadnamens aufgerufen werden. 

• Alle Ihre ARexx-Programme stehen an der gleichen Stelle. 

• Die meisten Anwendungsprogramme greifen bei der Suche nach 
ARexx-Programmen auf das Verzeichnis REXX: zu. 

Ein ARexx-Programm kbnnte nicht nur an beliebiger Stelle 
gespeichert, sondern auch beliebig benannt werden. Allerdings 
erleichtern Sie sich die Programmverwaltung sehr, wenn Sie eine 
einfache Benennungskonvention beachten: Programme, die von der 
Shell aus aufgerufen werden, sollten die Namenserweiterung .rexx 
erhalten. Auf diese Weise lassen sie sich von Dateien unterscheiden, 
die von anderen Anwendungen aufgerufen werden. 

2.2. 1 a Aufrufen von ARexx-Programmen 

Das Kommando RX dient zum Aufrufen eines ARexx-Programms. 
Wird zum Programmnamen ein vollstandiger Pfad angegeben, so 
wird nur das in diesem Pfad angegebene Verzeichnis nach dem 
Programm durchsucht. Wenn Sie keinen Pfad angeben, erstreckt 
sich die Suche auf das aktuelle Verzeichnis und das Verzeichnis 
REXX:. 
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Solange die Programme im Verzeichnis REXX: gespeichert sind, ist 
die Angabe der Erweiterung .rexx zum Programmnamen nicht 
erforderlich, d. h. die Eingabe von: 

RX Programm.rexx 

entspricht der Eingabe von: 

RX Programm 

Ein kurzes Programm kann auch direkt in der Kommandozeile 
eingegeben werden, indem die Programmzeile in doppelte Anfuh- 
rungszeichen gestellt wird. Das folgende Programm sendet z. B. 
funf Dateien mit den Namen myfile.l bis myfile.5 an den Drucker 
und muB als eine Zeile eingetippt werden: 

RX "DO i=l to 5; 

ADDRESS command 'copy myfile. 'Mi ' prt : ' ; END" 

Wenn eine Anwendung zu ARexx kompatibel ist, konnen innerhalb 
dieser Anwendung ARexx-Programme aufgerufen werden. Dazu 
wahlen Sie einen Meniipunkt aus oder geben bestimmte Kom- 
mandooptionen an. Naheres dazu entnehmen Sie bitte der 
Dokumentation zur jeweiligen Anwendung. 

ARexx-Programme konnen auch von der Workbench aus aufgerufen 
werden. Zu diesem Zweck erstellen Sie ein Programm- oder Projekt- 
piktogramm fur das Programm. Das Kommando RX muB als 
Standardprogramm fur das Piktogramm angegeben werden. In das 
Informationsfenster des Piktogramms geben Sie folgendes ein: 

Standardprogramm: SYS :Rexxc/RX 

Beim Offnen des Piktogramms startet RX das Programm RexxMast 
(wenn es nicht bereits lauft). Es fuhrt die dem Piktogramm 
zugeordnete Datei als ARexx-Programm aus. 

ARexx akzeptiert zwei Arten von Merkmalen: Console (zur Angabe 
eines Fensters) und CMD (zur Angabe einer Kommandozeichen- 
folge). Dieke Merkmale geben Sie in das Informationsfenster des 
Projektpiktogramms wie folgt ein: 

Console=CON: 0/0/640/2 00 /Example/Close 
CMD=rexxprogram 
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2.3 Programmbeispiele 

Die folgenden Beispiele zeigen, wie Sie ARexx zur Anzeige von 
Textzeichenfolgen am Bildschirm, zur Ausfuhrung von Berech- 
nungen und zum Aktivieren der Fehlerprlifroutine einsetzen 
konnen. 

Programme konnen uber jeden beliebigen Texteditor (z. B. ED oder 
MEmacs) oder ein Textverarbeitungsprogramm eingegeben werden. 
Bei Verwendung eines Textverarbeitungsprogramms speichern Sie 
Ihr Programm bitte als ASCII-Datei. ARexx unterstiitzt den 
erweiterten ASCII-Zeichensatz (A, IE, J3, Umlaute). Diese 
erweiterten Zeichen werden als gewohnliche Druckzeichen erkannt 
und auch korrekt von Klein- in Groflschreibung umgewandelt. 

Die Beispiele zeigen auch die Verwendung einiger syntaktischer 
Erfordernisse von ARexx, z. B: 

• Kommentarzeilen 

• Regeln fur Zeichenabstande 

• Unterscheidung zwischen Grofl- und Kleinschreibung 
Verwendung einzelner und doppelter Anfuhrungszeichen 

Jedes ARexx-Programm besteht mindestens aus einer das 
Programm beschreibenden Kommentarzeile und einem Befehl, der 
Text im Konsolenfenster anzeigt. ARexx-Programme miissen stets 
mit einer Kommentarzeile beginnen. Die einleitende Zeichenfolge /* 
(zu der stets eine AbschluBzeichenfolge */ vorhanden sein muB) teilt 
dem RexxMast-Interpreter mit, dafi es sich um ein ARexx- 
Programm handelt. Ohne die Zeichenfolgen /* und */ erkennt 
RexxMast die Datei nicht als ARexx-Programm. Nach Beginn der 
Programmausfiihrung ignoriert ARexx alle weiteren Kommentar- 
zeilen in der Datei. Die Kommentarzeilen sind jedoch zum 
Verstehen des Programms ausgesprochen hilfreich, da sie das 
Verstandnis der Logik und des Aufbaus des Programms wesentlich 
erleichtern. 

2.3.1 Amiga.rexx 

Dieses Programm zeigt, wie das Wort SAY in einem ARexx-Befehl 
zur Anzeige von Textzeichenfolgen am Bildschirm eingesetzt wird. 
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Befehle sind Sprachanweisungen, die eine bestimmte auszu- 
fuhrende Aktion naher bestimmen. Jede Anweisung beginnt mit 
einem Symbol, im folgenden Beispiel mit dem Wort SAY. (Symbole 
werden beim Programmablauf grundsatzlich in GroJJbuchstaben 
umgewandelt.) Auf SAY folgt ein Beispiel fur eine Zeichenfolge. 
Unter einer Zeichenfolge versteht man eine Reihe von Zeichen, die 
in ein Paar von einfachen (Apostroph, Alt-A) oder doppelten 
Anfuhrungszeichen eingeschlossen sind (' oder "). 

Programm 1. Amiga.rexx 

/*Ein einfaches Programm*/ 

SAY 'Amiga, der Kreativ-Computer . ' 

Geben Sie den obigen Programmtext ein und speichern Sie ihn 
unter dem Namen REXX:Amiga.rexx. Zum Aufrufen des Pro- 
gramms offnen Sie nun ein Shell-Fenster und geben folgendes ein: 

RX Amiga 

Der vollstandige Pfad- und Programmname lautet zwar 
Rexx:Amiga.rexx, Sie brauchen aber weder den Verzeichnisnamen 
REXX: noch die Namenserweiterung .rexx einzugeben, wenn Sie 
das Programm im Verzeichnis REXX: gespeichert haben. 

In Ihrem Shell-Fenster sollte nun der folgende Text erscheinen: 

Amiga, der Kreativ-Computer . 

2.3.2 Alter.rexx 

Dieses Programm zeigt eine Eingabeaufforderung an und liest dann 
die eingegebenen Daten. 

Programm 2. Alter.rexx 

/*Alter in Tagen berechnen*/ 

SAY 'Bitte Ihr Alter eingeben: 1 

PULL alter 

SAY 'Sie sind etwa ' alter*365 ' Tage alt. 1 

Speichern Sie dieses Programm unter dem Namen REXX: 
Alter.rexx und rufen Sie es mit dem folgenden Kommando auf: 

RX alter 
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Dieses Programm beginnt mit einer Kommentarzeile, die die 
Aufgabe des Programms beschreibt. Alle ARexx-Programme 
beginnen mit einem Kommentar. Der Befehl SAY dient zur Anzeige 
einer Eingabeaufforderung im Konsolenfenster. 

Der Befehl PULL liest die Eingabe des Benutzers - in diesem Fall 
also das Alter. PULL nimmt die Eingabe auf, wandelt sie 
gegebenenfalls in GroBbuchstaben um und speichert sie in einer 
Variablen ab. Variablen sind Symbole, denen ein Wert zugewiesen 
werden kann. Es empfiehlt sich, beschreibende Variablennamen zu 
wahlen. Hier wird der Name "alter" als Platzhalter fur die vom 
Benutzer einzugebende Zahl verwendet. 

Die letzte Zeile multipliziert die Variable "alter" mit 365 (Anzahl der 
Tage pro Jahr - Schaltjahre werden in diesem Beispiel ignoriert) 
und zeigt iiber den Befehl SAY das Ergebnis an. Beachten Sie, daB 
die Variable "alter" nicht als Zahl deklariert werden muBte, da ihr 
Wert zum Zeitpunkt der Verwendung im Ausdruck iiberpruft wird. 
(Hierbei handelt es sich um ein Beispiel fur typenlose Daten.) Wenn 
Sie sehen mochten, was passiert, wenn sie fur "alter" keine Zahl 
angeben, rufen Sie das Programm noch einmal auf und geben 
diesmal Buchstaben statt numerischer Zeichen fur das Alter ein. Es 
erscheint eine Fehlermeldung, die die Zeilennummer und die Art 
des aufgetretenen Fehlers angibt. 

2.3.3 Calc.rexx 

In diesem Programm wird der Befehl DO vorgestellt, mit dem 
Programmanweisungen wiederholt ausgefuhrt werden konnen. 
Ferner veranschaulicht es auch den Exponentialoperator (**). 
Geben Sie das Programm iiber den Texteditor bzw. das Textverar- 
beitungsprogramm ein und speichern Sie es unter dem Namen 
REXX:Calc.rexx. Verwenden Sie das Kommando "KX calc" zum 
Aufrufen des Programms. 
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Programm 3. Calc.rexx 

/*Berechnung von Quadraten und Kuben.*/ 

DO i = 1 to 10 /*Schleifenkopf - 10 Durchlaufe*/ 

SAY i i**2 i**3 /*Berechnungen und Ausgabe*/ 

END /*Schleifenende*/ 

SAY * fertig. ' 

Der Befehl DO bewirkt, daB die zwischen den Befehlen DO und 
END stehenden Anweisungen wiederholt ausgefuhrt werden. Die 
Variable "i" ist die Indexvariable fur die Programmschleife und 
erhoht sich bei jeder Wiederholung (Iteration) um 1. Die Zahl, die 
auf das Symbol TO folgt, ist der Endwert fur den Befehl DO und 
konnte statt der Konstanten 10 auch eine Variable oder ein 
vollstandiger Ausdruck sein. 

Allgemein verwenden AKexx-Programme einzelne Leerzeichen 
zwischen verschiedenen Befehlsbestandteilen. In Programm 3 
wurde allerdings auf Leerzeichen zwischen den Exponentialzeichen 
(**) und den Variablen und Konstanten (i und 2, i und 3) verzichtet. 

Beachten Sie, dafl die Anweisungen in der Schleife eingeruckt sind. 
Fur die Programmiersprache ist dies nicht erforderlich, es ver- 
bessert jedoch die Lesbarkeit des Programms, da Sie Anfang und 
Ende der Programmschleife auf einen Blick erkennen konnen. 



2.3.4 Gerade.rexx 

Der Befehl IF ermoglicht die Ausfuhrung einer Anweisung unter 
einer bestimmten Bedingung. Im vorliegenden Beispiel werden die 
Zahlen von 1 bis 10 als gerade oder ungerade klassifiziert, indem sie 
durch zwei dividiert und der Rest anschlieBend uberpriift wird. Der 
arithmetische Operator // berechnet den Rest (Modulo), der nach 
Ausfuhrung der Division verbleibt. 
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Programm 4. Gerade.rexx 

/*Gerade oder ungerade?*/ 

DO i = 1 to 10 /*Schleife beginnen - 10 Durchlaufe*/ 

IF i // 2 = THEN typ = ' gerade ' 
ELSE typ = ' ungerade ' 

SAY i * ist ' typ 

END /*Schleife beenden*/ 

Die IF-Zeile gibt an, daB im Falle eines Rests von bei Division der 
Variable "i" durch 2 die Variable "typ" auf gerade gesetzt wird. Ist 
der Rest ungleich 0, iiberspringt das Programm den THEN-Zweig 
und fuhrt stattdessen den ELSE-Zweig aus, d. h. die Variable "typ" 
wird auf ungerade gesetzt. 



2.3.5 Quadrat.rexx 

Dieses Beispiel stellt das Konzept einer Funktion vor, d. h. einer 
Gruppe von Anweisungen, die durch Angabe des Funktionsnamens 
in einem geeigneten Zusammenhang ausgefiihrt werden konnen. 
Mit Hilfe von Funktionen konnen Sie umfangreiche und komplexe 
Programme aus kleineren Modulen (Programmbausteinen) 
erstellen. Funktionen lassen auch die Verwendung desselben Pro- 
grammtextes fur ahnliche Operationen in verschiedenen Pro- 
grammteilen zu. 

Funktionen werden in einem Ausdruck als Name dargestellt, auf 
den eine offnende Klammer folgt. (Zwischen Name und Klammer 
stent kein Leerzeichen.) Ein oder mehrere Ausdriicke, die als 
Argumente bezeichnet werden, konnen auf die Klammer folgen. 
Nach dem letzten Argument muB eine schliefiende Klammer folgen. 
Diese Argumente leiten Informationen zur Verarbeitung an die 
Funktion weiter. 
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Programm 5. Quadrat.rexx 

/*Definieren und Aufrufen einer Funktion.*/ 
DO i = 1 to 5 

SAY i quadrat (i) /*Aufruf der Funktion "quadrat"*/ 

END 
EXIT 
quadrat : /*Funktionsname*/ 

ARG x /^Argument abrufen*/ 

RETURN x**2 /*quadrieren und zuriickgeben*/ 

Beginnend mit DO und endend auf END wird eine Schleife mit 
einer Indexvariablen "i" eingerichtet, die jeweils um 1 hochzahlt. 
Die Schleife wird funfmal durchlaufen. Die Schleife enthalt einen 
Ausdruck, der die Funktion "quadrat" aufruft, wenn der Ausdruck 
ausgewertet wird. Das Resultat der Funktion wird mittels des 
Befehls SAY angezeigt. 

Die Funktion "quadrat" ist durch die Befehle ARG und RETURN 
definiert und berechnet die Quadratwerte. ARG ruft den Wert aus 
der Argumentzeichenfolge "i" ab, RETURN leitet das Resultat der 
Funktion zurlick zum aufrufenden Befehl SAY. 

Sobald die Funktion von der Schleife aufgerufen wird, sucht das 
Programm nach dem Funktionsnamen "quadrat:", ruft anschlieflend 
das Argument "i" ab, fuhrt die Rechenoperation aus und kehrt zum 
Anfang der DO/END- Schleife zuriick. Der Befehl EXIT beendet das 
Programm nach dem letzten Scheifendurchlauf. 



2.3.6 Results.rexx 

Der Befehl TRACE aktiviert die Ablaufverfolgungsfunktion von 
ARexx. 

Programm 6. Results.rexx 

/ *Darstellung einer " Ergebnis " -Ablaut verf olgung* / 

TRACE results 

sum = ; sumq = ; 

DO i = 1 to 5 

sum = sum + 1 

sumq = sumq + i**2. 

END 
SAY ' sum= ' sum ' sumq- ' sumq 
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An der Konsole werden die Ausfuhrung der Zeilen des 
Quellprogramms fur jeden Durchlauf der DO/END-Schleife und 
anschlieBend die Endergebnisse des "Ausdrucks angezeigt. Wiirde 
der Befehl TRACE entfernt, wurde nur das Endergebnis angezeigt: 
sum = 15 sumq = 55. 



2.3 J Zensur.rexx 

Dieses Programm berechnet die AbschluBzensur fur einen 
bestimmten Schuler auf der Basis der erzielten Noten in vier 
Klausuren und einer Zensur fur die miindliche Beteiligung. Die 
Durchschnittsnote aus Klausur 1 und Klausur 2 soil 30 % zur 
AbschluBnote beitragen, die Durchschnittsnote aus Klausur 3 und 
Klausur 4 soil 45 % ausmachen, und die miindliche Beteiligung 
wird mit 25 % veranschlagt. Beachten Sie, dafi bei solchen Zahlen- 
werten der amerikanische Dezimalpunkt statt eines Kommas ge- 
schrieben werden muB. 

Nachdem das Programm die AbschluBzensur angezeigt hat, fragt es 
den Benutzer, ob er eine weitere Note berechnen will. Die Antwort 
wird eingelesen ("PULL"). Lautet sie nicht Q (Quittieren = 
Programm verlassen), wird die Schleife fortgesetzt. Lautet die 
Antwort Q, wird die Schleife verlassen und der Programmablauf 
beendet. 
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Programm 7. Zensur.rexx 

/ * Zensurenpr ogramm* / 

SAY "Hallo, ich berechne die Zensur fur Sie. 

response = 

DO while response ~ = "Q" 

/*Schleife, solange Antwort nicht Q ist*/ 

SAY "Bitte alle Einzelzensuren eingeben. " 

SAY "Klausur 1: 

PULL esl 

SAY "Klausur 

PULL es2 

SAY "Klausur 

PULL es3 

SAY "Klausur 

PULL es4 

SAY "Mundliche Beteiligung : " 

PULL p 

Note = (((esl + es2)/2*.3) + ( (es3 + es4)/2*.45) + (p*.25) 

SAY "Die AbschluSzensur ist" Note 

SAY "Wollen Sie weitermachen? (Mit Q beenden.)" 

PULL response 

END 
EXIT 



Kapitel3 

Elemente der 
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In diesem Kapitel werden die Regeln und Konzepte der Program- 
miersprache ARexx behandelt. Aufierdem wird erlautert, wie ARexx 
die in Programmen verwendeten Zeichen und Worter interpretiert. 
Die hier behandelten Elemente umfassen: 

. Token — das kleinste Element der ARexx-Spracr^e 

Klauseln — die kleinste ausfuhrbare Einheit - vergleichbar 
einem Satz 

• Ausdriicke — eine Gruppe ausgewerteter Tokens 

Die Kommandoschnittstelle — der Prozefl, uber den ARexx-Pro- 
gramme mit ARexx-kompatiblen Anwendungen kommunizieren 

Das Kapitel enthalt auch eine Beschreibung der Ausfuhrungs- 
umgebung von ARexx. Dieser Abschnitt richtet sich an erfahrene 
Amiga-Benutzer und enthalt technische Details zur Prozefl- 
kommunikation. 
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3. 1 Token 

Token sind die kleinsten separaten Einheiten der Programmier- 
sprache ARexx. Sie konnen aus einem oder mehreren Zeichen 
bestehen. Token konnen in funf Kategorien unterteilt werden: 

Kommentare 

Symbole 

Zeichenfolgen 

Operatoren 

Sonderzeichen 

3. 1. 1 Kommentare 

Jede Gruppe von Zeichen, die mit der Sequenz /* beginnt und mit */ 
endet, bildet einen Kommentar. Jedes ARexx-Programm mufl mit 
einem Kommentar beginnen. Zu jedem /* muiS ein entsprechendes */ 
vorhanden sein. Beispiel: 

/*Ein einfacher Kommentar in ARexx*/ 

Kommentare konnen iiberall im Programm plaziert und auch 
ineinander verschachtelt werden. Beispiel: 

/*Ein /*verschachtelter*/ Kommentar*/ 

Es empfiehlt sich, Programme mit zahlreichen Kommentaren 
auszustatten, die Ihnen und anderen Benutzern Zweck und 
Funktion des jeweiligen Programms in Erinnerung rufen. Der Kom- 
mandointerpreter ignoriert Kommentare beim Lesen der Pro- 
grammdateien - die Kommentare konnen also keine Verzogerung 
der Programmausfuhrung auslosen. 
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3.1.2 Symbole 

Unter einem Symbol versteht man eine beliebige Gruppe der 
Zeichen a-z, A-Z, 0-9 sowie Punkt (.), Ausrufezeichen (!), Frage- 
zeichen (?) Dollarzeichen ($) und Unterstreichung (_). Wenn der 
Interpreter ein Programm durchliest, werden Symbole in 
Grofibuchstaben ubersetzt. Das Symbol MeinName entspricht also 
MEINNAME. Vier Symbolarten werden erkannt: 

Feste Symbole Eine Gruppe numerischer Zeichen, die mit einer 

Ziffer (0-9) Oder einem Punkt (.) beginnt. Der Wert 
eines festen Symbols ist stets der Symbolname 
selbst, ubersetzt in GroBbuch-staben. 12345 ist ein 
Beispiel fur ein testes Symboi. 

Einfache Symbole Eine Gruppe alphabetischer Zeichen, die mit 

einem Buchstaben (A-Z) beginnt, z. B. 
"MeinName". 

Stammsymbole Eine Gruppe alphanumerischer Zeichen, die auf 

einen Punkt endet, z. B. "A." und "Stamm9." 

Zusamrnengesetzte Eine Gruppe alphanumerischer Zeichen, die 
Symbole mehrere Punkte enthalt, z. B. "A.1. Index". 

Einfache, zusamrnengesetzte und Stammsymbole werden als 
Variablen bezeichnet. Ihnen kann wahrend des Programmlaufs ein 
Wert zugewiesen werden. Solange eine Variable noch nicht mit 
einem Wert besetzt ist, ist sie nicht initialisiert. Fur nicht 
initialisierte Variablen wird als Wert der Variablenname selbst (ggf. 
ubersetzt in Grofibuchstaben) verwendet. 

Zusamrnengesetzte und Stammsymbole besitzen besondere Eigen- 
schaften, dje sie besonders fur den Aufbau von Variablenfeldern 
und Listen pradestinieren. Stammsymbole ermbglichen die Initiali- 
sierung einer ganzen Klasse zusammengesetzter Symbole. Ein 
zusammengesetztes Symbol hat dip Struktur Stamm.n^.n2 . . . nk, 
wobei der Ausgangsname ein Stammsymbol ist und jeder Knoten, 
ni. . . n^, ein festes oder einfaches Symbol. 

Wenn einem Stammsymbpl ein Wert zugeordnet wird, ordnet es 
seinerseits diesen Wert alien vom Stammsymbol abgeleiteten, 
zusammengesetzten Symbolen zu. Der Wert eines zusammen- 
gesetzten Symbols hangt also von den zuvor auf dieses Symbol oder 
den dazugehbrigen Stamm erfolgten Zuordnungen ab. 
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Wenn ein zusammengesetztes Symbol in einem Programm 
vorkommt, wird sein Name erweitert, indem jeder Knoten durch 
semen aktuellen Wert ersetzt wird. Die Wertzeichenfolge kann aus 
beliebigen Zeichen bestehen (einschlieBlich eingefugter Leer- 
zeichen) und wird nicht in GroBbuchstaben umgewandelt. Resultat 
der Erweiterung ist ein neuer Name, der anstelle des zusammen- 
gesetzten Symbols verwendet wird. Hat z. B. J den Wert 3 und K 
den Wert 7, wird das zusammengesetzte Symbol A.J.K zu A.3.7 
erweitert. 

Zusammengesetzte Symbole konnen als eine Form zuordnungs- 
abhangigen oder inhaltsadressierbaren ("assoziativen") Speichers 
betrachtet werden. Nehmen wir einmal an, Sie miissen eine Reihe 
von Namen und Telefonnummern speichern und abrufen. Die 
normale Vorgehensweise ware nun, zwei Felder (NAME und 
NUMMER) einzurichten und jedem eine Indexnummer (1 bis n, mit 
n = Gesamtanzahl der Eintrage) zu geben. Eine Nummer wlirde 
gesucht, indem man das Namensfeld durchliest, bis der gewiinschte 
Name gefunden wird, z. B. NAME. 12, dessen Telefonnummer 
NUMMER. 12 dann im anderen Feld abgelesen werden kann. 
Arbeitet man mit zusammengesetzten Symbolen, konnte das Symbol 
NAME den abzurufenden Namen enthalten, und NUMMER.NAME 
wlirde zur dazugehorigen Telefonnummer erweitert, z. B. 
NUMMER.CBM. 

Zusammengesetzte Symbole konnen auch als gewohnliche indizierte 
Felder verwendet werden, die den zusatzlichen Vorteil bieten, daB 
nur eine Zuweisung (auf den Stamm) erforderlich ist, um die 
gesamte Feldgruppe zu initialisiereng Das Programm im folgenden 
Beispiel verwendet die Stamme "nummer." und "adr." zur 
Erstellung eines elektronischen Telefonverzeichnisses. 
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Programm 8. TelNr.rexx 

/*Telefonverzeichnis zur Veranschaulichung 

zusammengesetzter Variablen.*/ 

IF' ' ARG "() ~ = 1 THEN DO 

SAY "VERWENDUNG: rx TelNr Name" 

EXIT 5 

END 
/*Zur Anzeige von Telef onnummern/Adressen Fenster 
of fnen. */ 

CALL OPEN out, "con: 0/0/640/60/ARexx Phonebook" 
IF - result THEN DO 

SAY "Of fnen- gescheitert . . . Sorry" 

EXIT 10 

END 
/*Nummerndef initionen*/ 
nummer. = ' (nicht gefunden) ' 
nummer.wsh = '(555) 001-0001 1 
adr. = ' (nicht gefunden) ' 
nummer. CBM = '(555) 002-0002' 
adr.CBM = '1200 Wilson Dr., West Chester, PA, 19380' 

/* (Eigentliche Arbeit schon getan)*/ 

ARG name /*Der Name*/ 

CALL WRITELN out , name I I "TelNr ist" nummer. name 

CALL WRITELN out , name II "Adresse ist" adr. name 

CALL WRITELN out, "Mit Eingabetaste Programm 

verlassen. " 

CALL READLN out 

EXIT 

Zum Aufrufen des Programms rufen Sie ein Shell-Fenster auf und 
geben folgendes ein: 

RX TelNr cbm 

Es erscheint ein Fenster mit dem CBM zugeordneten Namen und 
der Adresse. 
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3. 1.3 Zeichenfolgen 

Eine Zeichenfolge ist eine beliebige Gruppe von Zeichen, an deren 
Anfang und Ende einfache ( • ) oder doppelte ( " ) Anfuhrungszeichen 
als Begrenzungszeichen stehen. Am Ende der Zeichenfolge muB 
allerdings immer das gleiche Begrenzungszeichen stehen wie am 
Anfang. Wenn das Begrenzungszeichen selbst Bestandteil der 
Zeichenfolge sein soil, mufi es zweimal nacheinander angegeben 
werden ( ' ' oder " "). Beispiel: 

"Hallo Rumpel, " 
'haste mal ' ' ne Mark? 1 

Der Wert einer Zeichenfolge ist die Zeichenfolge selbst. Die Lange 
einer Zeichenfolge wird durch die Anzahl der Zeichen bestimmt. 
Wenn die Zeichenfolge keine Zeichen enthalt, wird sie als leere 
Zeichenfolge (Nullzeichenfolge) bezeichnet. 

Wenn auf eine Zeichenfolge unmittelbar ein X oder B folgt, handelt 
es sich um eine hexadezimale bzw. binare Zeichenfolge. Sie mufi 
sich aus hexadezimalen (0-9, A-F) bzw. binaren Ziffern (0,1) 
zusammensetzen. Beispiel: 

' 4A 3B CO *X 

'OOllOlll'B 

Leerzeichen sind an Bytegrenzen aus Griinden der Ubersicht- 
lichkeit zulassig. Hexadezimale und binare Zeichenfolgen eignen 
sich besonders fur nicht im ASCII-Code definierte Zeichen und fur 
maschinenspezifische Informationen, z. B. Adressen in einem Prq- 
gramm. §ie werden umgehend in die gepackte (komprimierte), 
maschineninterne Form umgewandelt. 



3.1.4 Operatoren 

Operatoren sind eine Kombination aus folgenden Zeichen: - + - * / 
= > < & I A . Darauf wird in diesem Abschnitt naher eingegangen. 
Man unterscheidet vier Arten von Operatoren: 

• Arithmetische Operatoren erfordern einen oder zwei 
numerische Operanden und ergeben ein numerisches Resultat. 
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• Verkettungsoperatoren verbinden zwei Zeichenfolgen zu einer 
Zeichenfolge. 

• Vergleichsoperatoren erfordern Operanden und ergeben ein 
boolesches Resultat (0 oder 1). 

• Logische Operatoren erfordern einen oder zwei boolesche 
Operanden und ergeben ein boolesches Resultat. 

Jedem Operator ist ein Prioritatswert zugeordnet, der die Reihen- 
folge bestimmt, in der die Operationen in einem Ausdruck ausge- 
fuhrt werden. Operatoren mit hoherer Prioritat (8) werden vor 
solchen mit niedriger Prioritat (1) ausgefiihrt. 

3. 1.4. 1 Arithmetische Operatoren 

Eine wichtige Klasse der Operatoren sind solche, die Zahlen 
darstellen. Zahlen bestehen aus den Zeichen 0-9, Punkt (.), 
Pluszeichen (+), Minuszeichen (-), und Leerzeichen. Zur Dar- 
stellung der Exponentialschreibweise kann auf eine Zahl ein V 
oder "E" und eine ganze Zahl (mit Vorzeichen) folgen. 

Zur Angabe von Zahlen konnen Zeichenfolgen und Symbole 
verwendet werden. Da die Sprache typenlos ist, imissen Variablen 
nicht vor der Verwendung in arithmetischen Operationen als 
numerisch deklariert werden. Statt dessen wird jede Wertzeichen- 
folge bei der Verarbeitung daraufhin uberpriift, ob sie eine Zahl 
darstellt. Die folgenden Beispiele stellen alle giiltige Zahlen dar: 

33 

" 12.3 " 

0.321el2 

' + 15. ' 

Voran- und nachgestellte Leerzeichen sind zulassig. Leerzeichen 
konnen zwischen einem Plus- oder Minuszeichen (+ oder -) und der 
darauffolgenden Zahl stehen, aber nicht innerhalb der Zahl selbst. 

Die fur arithmetische Berechnungen zu verwendende Basis- 
genauigkeit kann wahrend des Ablaufs eines Programms verandert 
werden. Die Anzahl geltender Stellen, die in arithmetischen 
Operationen verwendet werden, richtet sich nach der Vorgabe fur 
Numeric Digits (Numerische Ziflfern) und kann uber den Befehl 
NUMERIC verandert werden. Naheres dazu siehe Kapitel 4.2. 
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Die Anzahl der fur ein Resultat zulassigen Dezimalstellen hangt 
von der Operation und den Dezimalstellen der beteiligten Operan- 
den ab. ARexx verwendet ggf. abschlieBende Nullen zur Anzeige der 
Genauigkeit des Resultats. Wenn die Gesamtzahl der zur Wieder- 
gabe eines Wertes erforderlichen Ziffern groBer ist als die Vorein- 
stellung fur Numeric Digits, wird die Zahl in Exponentialschreib- 
weise formatiert. Dafiir gibt es folgende Moglichkeiten: 

• Wissenschaftliche Schreibweise — der Exponent wird so 
angepaBt, dafi links vom Dezimalkomma nur eine Ziffer steht. 

• Technische Schreibweise — die Zahl wird skaliert, so daB der 
Exponent ein Vielfaches von 3 ist und die Ziffern links vom 
Dezimalkomma im Bereich von 1 bis 999 liegen. 

Tabelle 3-1 zeigt eine Liste arithmetischer Operatoren. 
Tabelle 3-1. Arithmetische Operatoren 



Operator 


Prioritat 


Beispiel 


Resultat 


+ (Vorzeichen) 


8 


+'3.12' 


3.12 


- (negatives Vorzeichen) 


8 


-"3.12" 


-3.12 


** (Potenzierung) 


7 


0.5 ** 3 


0.125 


* (Multiplikation) 


6 


1.5*1.50 


2.250 


/ (Division) 


6 


6/3 


2 


% (Ganzzahldivision) 


6 


-8 % 3 


-2 


// (Rest) 


6 


5.1//0.2 


0.1 


+ (Addition) 


5 


3.1+4.05 


7.15 


- (Subtraktion) 


5 


5.55-1 


4.55 



3. 1.4.2 Verkettungsoperatoren 

ARexx definiert zwei Verkettungsoperatoren. Der erste, der durch 
die Operatorzeichenfolge I I (zwei senkrechte Striche) gekenn- 
zeichnet ist, verbindet zwei Zeichenfolgen zu einer Zeichenfolge, 
ohne daB zwischen den Ausgangszeichenfolgen ein Leerzeichen 
eingefugt wird. Diese Art der Verkettung kann auch implizit 
angegeben werden. Wenn ein Symbol und eine Zeichenfolge ohne 
jedes Leerzeichen eingegeben werden, verhalt sich ARexx so, als 
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ware der Operator I I angegeben worden. Die zweite Verkettungs- 
operation ist durch den Leerzeichenoperator gekennzeichnet und 
fiigt die zwei Operandenzeichenfolgen zusammen, wobei zwischen 
beide ein Leerzeichen gesetzt wird. 

Alle Verknupfungsoperationen haben die Prioritat 4. Tabelle 3-2 
faBt die verschiedenen Operationen zusammen. 

Tabelle 3-2. Verkettungsoperatoren 



Operator 


Operation 


Beispiel 


Resultat 


II 


Verkettung 


'Is was/II'Doc?' 


Is was,Doc? 


Leerzeichen 


Verkettung mit 
Leerzeichen 


'Guten 1 Tag 1 


Guten Tag 


Keiner 


Implizite 
Verkettung 


eins'zwei'drei 


EINSzweiDREI 



3. 1.4.3 Vergleichsoperatoren 

ARexx unterstiitzt drei Arten von Vergleichen: 

• Exakte Vergleiche — der Vergleich erfolgt zeichenweise 

• Zeichenfolgenvergleich — fuhrende Leerzeichen werden igno- 
riert, an die ktirzere Zeichenfolge werden Leerzeichen angefiigt 
Numerische Vergleiche — die Operanden werden auf der Basis 
der Voreinstellung fur Numeric Digits in ein internes 
numerisches Format umgewandelt; anschlieBend wird ein 
arithmetischer Vergleich ausgefuhrt 

Vergleiche ergeben stets einen booleschen Wert. Die Ziffern und 1 
dienen zur Darstellung der booleschen Werte "false" und "true" 
("falsch" und "wahr"). Wenn ein boolescher Operand erwartet wird, 
fuhrt die Verwendung eines anderen Wertes als oder 1 zu einem 
Fehler. Als boolescher Wert wird auch jede Zahl akzeptiert, die 
oder 1 aquivalent ist, z. B. 0.000 oder 0.1E1. 

Mit Ausnahme der Operatoren fur exakte Gleichheit (==) und 
exakte Ungleichheit (~==) bestimmen alle Vergleichsoperatoren 
dynamisch, ob ein Zeichenfolgenvergleich oder ein numerischer 
Vergleich auszufuhren ist. Ein numerischer Vergleich erfolgt, wenn 
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beide Operanden giiltige Zahlen sind. Andernfalls werden die 
Operanden als Zeichenfolgen verglichen. 

Alle Vergleiche haben die Prioritat 3. Tabelle 3-3 zeigt eine Liste der 
zulassigen Vergleichsoperatoren. 

Tabelle 3-3. Vergleichsoperatoren 



Operator 


Operation 


Modus 


== 


Exakte Gleichheit 


Exakt 


~== 


Exakte Ungleichheit 


Exakt 


= 


Gleichheit 


Zeichenfolge/Numerisch 


~= 


Ungleichheit 


Zeichenfolge/Numerisch 


> 


GroBer als 


Zeichenfolge/Numerisch 


>= Oder ~< 


GroGer als oder gleich 


Zeichenfolge/Numerisch 


< 


Kleiner als 


Zeichenfolge/Numerisch 


<= oder ~> 


Kleiner als oder gleich 


Zeichenfolge/Numerisch 



3. 1.4.4 Logische (Boolesche) Operatoren 

ARexx definiert die vier logischen Operationen NICHT, UND, 
ODER und Exklusiv-ODER. Alle diese Operationen benotigen 
boolesche Operanden und ergeben ein boolesches Resultat. Der 
Versuch, mit anderen als booleschen Operanden eine logische 
Operation auszufuhren, fuhrt zu einem Fehler. Tabelle 3-4 zeigt 
eine Liste der zulassigen logischen Operatoren. 

Tabelle 3-4. Logische Operatoren 
Operator Prioritat Operation 





8 


Logisches NICHT (Umkehrung) 


& 


2 


Logisches UND 


I 


1 


Logisches ODER 


A oder && 


1 


Logisches Exklusiv-ODER 
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3. 1.5 Sonderzeichen 

Einige Interpunktionszeichen besitzen innerhalb von ARexx eine 
spezielle Bedeutung, wie Tabelle 3-5 veranschaulicht. 

Tabelle 3-5. Sonderzeichen 
Sonderzeichen Definition 



(:) Doppelpunkt 
( ) Klammern 



(;) Semikolon 



(,) Komma 



Ein Doppelpunkt, dem ein Symbol-Token (ein 
alphanumerisches Zeichen oder . ! ? $) vorangestellt 
ist, definiert eine Sprungmarke in einem Programm. 

Klammern werden in Ausdrucken dazu verwendet, 
Operatoren und Operanden in Unterausdrucken 
zusammenzufassen und so die normalen Prioritats- 
werte der betreffenden Operatoren aufzuheben. Eine 
offnende Klammer dient auch zur Kennzeichnung eines 
Funktionsaufrufs innerhalb eines Ausdrucks. Ein 
Symbol oder eine Zeichenfolge, worauf unmittel-bar 
eine offnende Klammer folgt, definiert einen 
Funktionsnamen. Innerhalb einer Anweisung muf3 die 
Anzahl offnender und schlieBender Klammern jeweils 
gleich sein. 

Das Semikolon dient als Endezeichen einer An- 
weisung. Wenn Sie mehrere kurze Anweisungen 
haben, die in eine Zeile passen, werden diese durch 
Semikolons voneinander getrennt. 

Das Komma dient als Fortsetzungszeichen am 
Zeilenende fur Anweisungen, die in mehrere Zeilen 
aufgeteiit wurden, und als Trennzeichen zwischen 
Argumentausdrucken innerhalb eines Funktionsauf- 
rufs. 



3.2 Klauseln 

Eine Klausel wird aus Token-Gruppen gebildet und stellt die 
kleinste als Anweisung ausfuhrbare Spracheinheit dar. 

Beim Lesen des Programms teilt der Sprachinterpreter das 
Programm in Klauselgruppen auf. Diese Gruppen mit einer oder 
mehreren Klauseln werden dann weiter in Token aufgeteiit, und 
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jede Klausel wird dann unter einem bestimmten Typ klassifiziert. 
Dabei konnen unscheinbare syntaktische Unterschiede den seman- 
tischen Inhalt einer Anweisung vollstandig verandern. Beispiel: 

SAY 'Hallo, Willi' 

ist eine Befehlsklausel und zeigt "Hallo, Willi" auf der Konsole an, 
aber: 

1 'SAY 'Hallo, Willi 1 

ist eine Kommandoklausel, und gibt "SAY Hallo, Willi" als 
Kommando an ein externes Programm aus. Die fuhrende Null- 
zeichenfolge (' ') wirkt sich also auf die Klassifizierung aus: aus 
einer Befehlsklausel wird eine Kommandoklausel. 

Das Zeilenende gilt in der Regel implizit als Ende einer Klausel. 
Eine Klausel kann jedoch auch in der folgenden Zeile fortgesetzt 
werden. Dazu muB die erste Zeile mit einem Komma abgeschlossen 
werden. Das Komma wird vom Programm ignoriert, und die 
nachste Zeile wird als Fortsetzung der Klausel interpretiert. Fur 
solche Fortsetzungen gibt es kein festgelegtes Maximum (abgesehen 
davon, daB die GroBe des Kommandopuffers nicht uberschritten 
werden darf). 

Zeichenfolgen- und Kommentar-Token werden automatisch fortge- 
setzt, wenn die Zeile vor Erreichen des abschlieJJenden Begren- 
zungszeichens beendet ist. Das Zeichen fur Neue Zeile (das mit der 
Eingabetaste generiert wird) wird nicht als Bestandteil des Tokens 
betrachtet. 



3.2.1 Null-Klauseln 

Zeilen, die lediglich aus Leerzeichen oder Kommentaren bestehen, 
werden als Null-Klauseln bezeichnet. Sie konnen an jeder 
beliebigen Stelle in einem Programm vorkommen. Fur die Aus- 
fuhrung des Programms sind sie ohne Bedeutung. Sie verbessern 
jedoch die Ubersichtlichkeit des Programms und erhohen die 
Zeilenzahl. 
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3.2.2 Sprungmarkenklauseln 

Ein Symbol, auf das ein Doppelpunkt (:) folgt, wird als Sprung- 
markenklausel bezeichnet. Eine Sprungmarke dient als Markie- 
rungszeichen in einem Programm. Die Ausfuhrung einer Sprung- 
marke hat jedoch keine Aktion zur Folge. Der Doppelpunkt wird als 
implizites Beendigungszeichen einer Klausel betrachtet, d. h. jede 
Sprungmarke bildet eine separate Klausel. Sprungmarkenklauseln 
konnen an jeder beliebigen Stelle im Programm vorkommen. 
Beispiel: 

start: /*Ausfuhrung beginnen*/ 

syntax : / *Fehlerbehandlung* / 

3.2.3 Zuweisungsklauseln 

Zuweisungsklauseln werden durch ein Variablensymbol gekenn- 
zeichnet, auf das der Operator = folgt. (In diesem Kontext wird die 
normale Definition des Operators = - Priifung auf Gleichheit - 
aufgehoben.) Die Token rechts vom Gleichheitszeichen werden als 
Ausdruck ausgewertet, und das Ergebnis wird der Variablen zuge- 
ordnet. Beispiel: 

when = ' Jetzt ist es soweit ' 
answ = 3 .14 * fact (5) 

Das Gleichheitszeichen (=) weist den Wert 'Jetzt ist es soweit' der 
Variablen 'when' und das Ergebnis der Rechenoperation 3.14 * 
fact(5) der Variablen 'answ' zu. 



3.2.4 Befehlsklauseln 

Befehlsklauseln beginnen mit dem Namen des Befehls und weisen 
ARexx zur Ausfuhrung einer Aktion an. Befehlsnamen werden in 
Kapitel 4 beschrieben. Beispiel: 

DROP a b c 

SAY 'bitte' 

IF j > 5 THEN LEAVE; 
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3.2.5 Kommandoklauseln 

Kommandoklauseln sind alle ARexx-Ausdrucke, die nicht unter die 
bisher beschriebenen Klauselkategorien fallen. Der Ausdruck wird 
ausgewertet, und das Resultat wird als Kommando an einen 
externen Host (s. u., "Gastgeberprogramm") ausgegeben. Beispiel: 

'delete' 'Datei' /*Ein AmigaDOS-Bef ehl*/ 
'jump' current+10 /*Ein Editorbef ehl*/ 

Der Befehl "delete" wird nicht als ARexx-Kommando erkannt und 
daher an einen externen Host - in diesem Fall AmigaDOS - 
gesendet. Der Befehl "jump" im zweiten Beispiel wird normaler- 
weise von einem externen Texteditor verstanden. 



3.3 Ausdrucke 



Unter Ausdriicken versteht man eine Gruppe ausgewerteter 
Tokens. Die meisten Anweisungen enthalten zumindest einen Aus- 
druck. Ausdrucke setzen sich aus folgenden Komponenten zu- 

sammen: 

• Zeichenfolgen — Der Wert einer Zeichenfolge ist die 
Zeichenfolge selbst. 

• Symbole — Der Wert eines festen Symbols ist das Symbol selbst, 
umgewandelt in Groflbuchstaben. Symbole konnen als 
Variablen verwendet werden und einen zugewiesenen Wert 
haben. 

• Operatoren — Operatoren besitzen einen Prioritatswert, der 
festlegt, an welcher Stelle innerhalb der Gesamtreihenfolge die 
einzelnen Operatoren ausgefuhrt werden. 

• Klammern — Runde Klammern konnen verwendet werden, um 
die Reihenfolge der Auswertung in einem Ausdruck zu veran- 
dern oder um Funktionsaufrufe zu kennzeichnen. Ein Symbol 
oder eine Zeichenfolge, auf das/die unmittelbar eine offnende 
Klammer folgt, definiert den Namen der Funktion, die Tokens 
zwischen offnender und schlieBender Klammer bilden die Argu- 
mentliste der Funktion. So setzt sich z. B. der Ausdruck: 
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J 'Fakultat ist' fact (J) 

aus folgenden Komponenten zusammen: 

- ein Symbol — J 

- ein Leeroperator 

- eine Zeichenfolge — Fakultat ist 

- ein weiteres Leerzeichen 

- ein Symbol — fact 

- eine offnende Klammer 

- ein Symbol — J 

- eine schlieBende Klammer 

In diesem Beispiel ist FACT der Funktionsname und (J) die 
dazugehorige Argumentenliste, die in diesem Fall nur den einzelnen 
Ausdruck J umfaBt. 

Bevor die Auswertung eines Ausdrucks stattfinden kann, benotigt 
ARexx einen Wert fur jedes Symbol in dem Ausdruck. Bei festen 
Symbolen ist dieser Wert der Symbolname selbst, variable Symbole 
miissen dagegen in der aktuellen Symboltabelle nachgesehen 
werden. Im obigen Beispiel wiirde der Ausdruck unter der Voraus- 
setzung, dafi dem Symbol J der Wert 3 zugewiesen wird, wie folgt 
aussehen: 

3 'Fakultat ist' FACT (3). 

Zur Vermeidung von Unklarheiten beziiglich der Werte, die den 
Symbolen wahrend des Auflosungsprozesses zugewiesen werden, 
garantiert ARexx die strikte Einhaltung der Auflosungsreihenfolge 
von links nach rechts. Die Symbolauflosung wird ungeachtet der 
Prioritat des Operators und der Anordnung der Klammern 
fortgesetzt. Wird ein Funktionsaufruf festgestellt, wird die 
Auflosung wahrend der Auswertung der Funktion ausgesetzt. 
Beachten Sie bitte, daB ein und dasselbe Symbol innerhalb eines 
Ausdrucks mehr als einen Wert annehmen kann. 

Nehmen wir an, das obige Beispiel wiirde wie folgt umgestellt: 

FACT (J) 'ist' J 'Fakultat' 

Wiirde nun das zweite J ebenfalls in den Wert 3 aufgelost? 
Allgemein konnen Funktionsaufrufe Nebeneffekte haben, z. B. die 
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Veranderung der Variablenwerte. Der Aufruf FACT im umge- 
stellten Beispiel konnte also eine Veranderung des Werts von J zur 
Folge haben, so daB beim zweiten Vorkommen von J schon der neue 
Wert wirksam wird. 

Nach Auflosung aller Symbolwerte wird der Ausdruck ausgehend 
von den Prioritatswerten der Operatoren und der Anordnung der 
Klammerausdriicke ausgewertet. Bei der Auswertung von Opera- 
toren mit gleichem Prioritatswert garantiert ARexx keine 
bestimmte Reihenfolge. Ferner verwendet ARexx bei der Aus- 
wertung boolescher Operationen keine "Abkiirzungen". In dem 
Ausdruck: 

(1 = 2) & (FACT (3) = 6) 

wird z. B, die Funktion FACT aufgerufen, obwohl der erste Term 
der UND- (&-) Operation ist. An diesem Beispiel wird deutlich, 
daB ARexx mit dem Lesen des Programms von links nach rechts 
fortfahrt, obwohl die erste Klammer im Beispiel logisch falsch ist 
und einen Wert von ergibt. 



3.4 Die Kommandoschnittstelle 

Die ARexx-Kommandoschnittstelle ist ein allgemein zuganglicher 
Message-Port. Zu ARexx kompatible Anwendungen miissen iiber 
diesen Message-Port verfugen. ARexx-Programme geben Komman- 
dos aus, indem sie die Kommandozeichenfolge in ein Message-Paket 
stellen und dieses Paket an den Message-Port des Hosts 
(Gastprogramms) senden. Das Programm setzt die Operation aus, 
solange der Host die Kommandos verarbeitet. Wenn das Nachrich- 
tenpaket zuriickgemeldet wird, wird die Operation wieder aufge- 
nommen. 



3 A. 1 Host-Adresse 

ARexx verwaltet zwei implizite Host (Gastprogramm) - Adressen - 
einen aktuellen und einen vorhergegangenen Wert - als Bestandteil 
der Speicherumgebung des Programms. Diese Werte konnen iiber 
den Befehl ADDRESS jederzeit geandert werden (oder iiber das 
Synonym SHELL). Die aktuelle Host-Adresse kann mit Hilfe der 



Elemente der Programmiersprache ARexx 3-17 



integrierten Funktion ADDRESSO abgefragt werden. Die Standard- 
zeichenfolge fur die Host-Adresse ist REXX, diese kann jedoch bei 
Aufruf eines Programms neu gesetzt werden. Die meisten Host- 
Anwendungen liefern den Namen ihres allgemein zuganglichen 
Ports mit, wenn sie ein Makro-Programm aufrufen, so daB das 
Makro automatisch Kommandos zuriick an den Host ausgeben 
kann. 

Eine spezielle Host-Adresse wird erkannt. Die Zeichenfolge 
COMMAND gibt an, dafl das Makro direkt an AmigaDOS 
ausgegeben werden sollte. Bei alien anderen Host-Adressen wird 
davon ausgegangen, daB sie sich auf einen offentlichen Message- 
Port beziehen. Der Versuch, ein Kommando an einen nicht 
existenten Message-Port zu senden, fuhrt zu einem Syntaxfehler 
("Host-Umgebung nicht gefunden"). 

Programm 9 zeigt die Interaktion zwischen ARexx und dem 
AmigaDOS-Editor, ED. Das Programm stellt fest, ob ED lauft, 
bestimmt den Namen des Message-Ports und richtet einige 
Stammvariablen ein. 
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Programm 9. ED-Status.rexx 

/*Gibt den Status von ED aus . ED mu£ laufen, bevor 

dieses Programm gestartet wird. ED-Ports heiteen 'Ed' 

'Ed_l ' , ' Ed_2 ' usw.V 

DEFAULT_ED = "Ed" / *Gro£-/Kleinschreibung ist hier 

relevant*/ 

/*Prozedur fur den Fall, da£ ED nicht oder nur als 

Zweitaufruf (oder noch hoher) lauft.*/ 

DO WHILE - SHOW{ 'p' ,DEFAULT_ED) /*Port suchenV 

SAY "Nicht gefunden: Port mit Namen" DEFAULT_ED 

SAY "Verfugbare Ports:" 

SAY SHOW( 'P' ) ' Oa'X 

SAY "Anderen Port-Namen eingeben oder mit QUIT 

Programm verlassen" 

/* Der Benutzer soil den Port wahlen, wenn das 

Programm inn nicht findet */ 

DEFAULT_ED = READLN ( stdin) 

IF STRIP (UPPER (DEFAULT_ED) ) = 'QUIT 1 then exit 10 

/*Benutzer kann Programm hierdurch verlassen*/ 

END 
SAY "Benutzt wird ED-Port" DEFAULT_ED 
/*Nun, da der Port gefunden ist, soil ARexx ihn 
adressieren . * / 
ADDRESS VALUE DEFAULT_ED 
/*Einige niitzliche Stammvariablen einrichten*/ 



STEM.O 
STEM.l 
STEM. 2 
STEM . 3 
STEM. 4 
STEM. 5 
STEM. 6 
STEM. 7 
STEM. 8 



15 /*Anzahl ED-ARexx-Varlablen*/ 

'LEFT' /^Linker Rand (SL)*/ 

'RIGHT' /*Rechter Rand (SR)*/ 

'TABSTOP' /*Tabulatoren (ST) */ 

1 LMAX ' /^Maximal anzeigbare Zeilen*/ 

'WIDTH' /*Breite der Anzeige in Zeichen*/ 



= 'X' 

= ' Y' 

= ' BASE ' 

/*Basis ist 0, 



/*Phys. X-Pos. am Bildschirm ab 1*/ 
/*Phys. Y-Pos. am Bildschirm ab 1*/ 

/*Fensterbasis*/ 
es sei denn, die Anzeige wird*/ 
/*nach rechts verschoben*/ 
STEM. 9 = 'EXTEND* /*Randwert erweitern (EX)*/ 
STEM. 10 = 'FORCECASE' /*Gro£-/Kleinschreibung*/ 
STEM. 11 = 'LINE 1 /*Aktuelle Zeilenzahl*/ 

STEM. 12 = 'FILENAME' /*Datei wird ediert*/ 

STEM. 13 = 'CURRENT' /*Text der aktuellen Zeile*/ 
STEM. 14 = 'LASTCMD' /*Letztes erweitertes KommandoV 
STEM. 15 = 'SEARCH' /*Letzte Suchzeichenf olge* / 
/*ED soil Werte in Stammvariable 'STEM.' stellen.*/ 
' RV '/STEM/' /*RV ist ein ED-Kommando zum Senden 
von Infos von ED an ARexx*/ 
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/*STEM.l ist LEFT, und' STEM . LEFT hat nun einen Wert 
von ED. So konnen diese Daten ausgedruckt werden:*/ 

DO i = 1 to STEM. 

ED_VAR = STEM.i 

SAY STEM.i "=" STEM.ED_VAR / *ED-Variablen und Werte 

drucken* / 

END 

3.4.2 Erstellen eines Makros 

ARexx kann zum Schreiben von Programmen fur jede Host- 
Anwendung eingesetzt werden, die iiber eine kompatible Komman- 
doschnittstelle verfugt. Manche Anwendungsprogramme sind auf 
der Basis einer integrierten Makro-Sprache geschrieben und 
konnen zahlreiche vordefinierte Makro-Kommandos anbieten. 

Uberpriifen Sie das Anwendungsprogramm auf "Shortcut"-Kom- 
mandos (Tastenbefehle). Manche Programme bieten leistungsstarke 
Funktionen, die speziell fur den Aufruf von Makro-Programmen aus 
implementiert wurden. 

Die Interpretation der empfangenen Kommandos hangt ausschlieB- 
lich von der jeweiligen Host-Anwendung ab. Im einfachsten Fall 
entsprechen die Kommandozeichenfolgen exakt den Kommandos, 
die vom Benutzer eingegeben werden konnen. So werden z. B. die 
Positionssteuerkommandos (Auf/Ab) eines Texteditors wahrschein- 
lich gleich interpretiert. Andere Kommandos sind aber moglicher- 
weise nur giiltig, wenn sie von einem Makro aus gegeben werden. 
Ein Kommando zur Simulation einer Memioperation wiirde wohl 
kaum von einem Benutzer eingegeben. In Beispiel 10 wird das 
ARexx-Programm von ED zur Vertauschung zweier Zeichen 
aufgerufen. 
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Programm 10. Transpose.rexx 

/*Gegebene Zeichenfolge ' 123 ' , wenn Cursor auf 3 ist, 
wandelt das Makro die Zeichenkette in '213' urn.*/ 

HOST = ADDRESS ( ) /*Von welchem ED kam der Aufruf?*/ 

ADDRESS VALUE HOST 

/*. . . mit Editor kommunizieren. */ 

■rv 1 '/CURR/' /*ED soil Info in Stamm CURR stellen*/ 

/*Wir brauchen zwei Angaben:*/ 

currpos • = CURR.X /*Cursorposition in der Zeile*/ 

currlin = CURR. CURRENT 

/*Inhalt der aktuellen Zeile*/ 

IF (currpos >2 ) /*Mindestens 3. Schreibstellen*/ 

THEN currpos = currpos - 1 

ELSE DO /*Fehler melden und Programm verlassen*/ 

1 sm /Cursor muE mind, auf Pos . 3 stehen/ ' 

EXIT 10 
END 

/*Zeichen CURRPOS und CURRPOS-1 vertauschen und 
aktuelle Zeile durch neue Zeile ersetzen. */ 
DROP CURR. /* STEM-Variable CURR wird nicht mehr 
gebraucht ; Speicherplatz einsparen */ 

'd 1 /*ED soil aktuelle Zeile loschen*/ 

currlin = swapch (currpos, currlin) /*2 Zeichen 

tauschen*/ 

' i /'I | currlin | | '/' /*Geanderte Zeile einfiigen*/ 

DO i = 1 to currpos / *Cursor zuriick an alte 

Stelle*/ 

' cr ' /*ED~Kommando 'Cursor nach rechts 1 */ 

END 
EXIT /*Alles erledigt*/ 
/ *Funktion zum Austauschen zweier Zeichen* / 
swapch : procedure 
PARSE ARG epos, clin 

chl = substr (clin, epos, 1) /*Zeichen holen*/ 

clin = delstr (clin, epos, 1) /*L6schen aus 
Zeichenfolge*/ 

clin = insert (chl , clin, cpos-2 , 1) /*Einfugen, urn 
Transposition zu komplettieren*/ 
RETURN clin /*Geanderte Zeichenfolge zuriickgeben*/ 
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Zum Aufrufen dieses Beispiels von ED aus driicken Sie bitte ESC 
und geben folgendes ein: 

RX "Rexx: transpose . rexx" 

Hier muB die voile Pfadangabe und die Namenserweiterung ange- 
geben werden. 

Diese Zeichenfolge kann natiirlich auch einer Funktionstaste zuge- 
ordnet werden. 



3A.3 Ruckgabecodes 

Nach AbschluB der Kommandoverarbeitung meldet der Host den 
Kommandostatus in Form eines Ruckgabecodes. Die bei den ein- 
zelnen Kommandos moglichen Ruckgabecodes lesen Sie bitte in der 
Dokumentation zur Host-Anwendung nach. Diese Codes zeigen an, 
ob die vom Kommando ausgefuhrte Operation erfolgreich war. 

Dieser Ruckgabecode wird in die ARexx-Spezialvariable RC gestellt, 
damit er vom Makro gepriift werden kann. Der Wert Null zeigt an, 
daB das Kommando erfolgreich ausgefuhrt wurde. Eine positive 
ganze Zahl weist auf eine Fehlerbedingung hin. Je hoher die Zahl, 
desto schwerer der Fehler. Aus dem Ruckgabecode kann das Makro- 
Programm schlieBen, ob das Kommando ausgefuhrt wurde bzw. ob 
im Falle des Scheiterns eine Aktion erforderlich ist. 



3AA Kommando-Shells 

ARexx ist zwar so aufgebaut, daB mit Programmen, die seine 
spezifische Kommandoschnittstelle unterstiitzen, am effektivsten 
gearbeitet werden kann, es kann aber grundsatzlich mit jedem 
Kommando-Shell-Programm eingesetzt werden, das standard- 
maBige E/A-Mechanismen zum Abrufen seines Datenstroms unter- 
stutzt. Eine Moglichkeit, ARexx einzusetzen, besteht darin, eine 
Befehlsdatei in der RAM-Disk zu erstellen und diese direkt an die 
Shell weiterzuleiten. In Programm 11 wird eine neue Shell zur 
Ausfuhrung eines standardmaBigen EXECUTE-Skripts geoffhet: 
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Programm 11. Shell. rexx 

/*Neue Shell starten*/ 

ADDRESS command 

conwindow = "CON: 0/0/640/100/NeueShell/Close" 

/*Befehlsdatei erstellen*/ 

CALL OPEN out , "ram: temp" .write 

CALL WRITELN out, 'echo "Dies ist ein Test"' 

CALL CLOSE out 

,/*Neues Shell-Fenster offnen*/ 
'newshell' conwindow "ram: temp" 
EXIT 



3,5 Die Ausfuhrungsumgebung 



Hinweis Die folgenden Informationen richten sich an erfahrene 
Amiga-Benutzer. Sie setzen ein Grundlagenwissen liber 
das Amiga-Betriebssystem und die Kenntnis der Amiga 
ROM Kernel Manuals voraus. 

Der ARexx-Interpreter RexxMast bietet eine einheitliche Ausfuh- 
rungsumgebung, indem er jedes Programm als separaten Prozefi im 
Multitasking-Betriebssystem des Amiga ausfuhrt. Damit verfugen 
Sie iiber eine flexible Schnittstelle zwischen einem externen Host- 
Programm und RexxMast. Das Host-Programm kann seine Opera- 
tionen entweder gleichzeitig ausfuhren oder warten, bis das 
interpretierte ARexx-Programm abgeschlossen ist. Jedes ARexx- 
Programm besitzt eine externe und eine interne Umgebung. 



3.5. 1 Externe Umgebung 

Zur externen Umgebung eines Programms gehoren seine 
Prozeflstruktur, die Ein- und Ausgabestrbme sowie das aktuelle 
Verzeichnis. Bei der Erstellung jedes ARexx-Prozesses iibernimmt 
dieser die Ein- und Ausgabestrome von seinem Klienten, also dem 
externen Programm, das das ARexx-Programm aufrief. Wurde z. B. 
ein ARexx-Programm von einer Shell aus gestartet, iibernimmt das 
ARexx-Programm die Ein- und Ausgabestrbme sowie das aktuelle 
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Verzeichnis dieser Shell. Die Suche nach einer Programm- oder 
Datendatei geht dann vom aktuellen Verzeichnis aus. Fur externe 
Funktionen gilt ein Maximum von 15 Argumenten. 



3.5.2 Interne Umgebung 

Die interne Umgebung eines ARexx-Programms besteht aus einer 
statischen globalen Struktur und einer oder mehreren Speicher- 
umgebungen. Die globalen Datenwerte sind zum Zeitpunkt des 
Programmaufrufs feste Werte (statisch). Zu diesen Werten gehoren 
der Quelltext des Programms, statische Datenzeichenfolgen und 
Argumentzeichenfolgen. Sobald das Programm lauft, konnen diese 
Werte nicht mehr geandert werden. 

ARexx-Programme, die als Kommandos aufgerufen werden, 
besitzen in der Regel nur eine Argumentzeichenfolge, auch wenn 
die Moglichkeit zur Aufspaltung des Kommandos (Tokenisierung) 
die Moglichkeit zur Verwendung mehrerer Argumentzeichenfolgen 
bietet. Ein als interne Funktion aufgerufenes Programm kann eine 
beliebige Anzahl Argumente besitzen. Diese Argumente bleiben fur 
die Dauer des Programmablaufs bestehen. 

Die Speicherumgebung umfaBt die Symboltabelle, die fur 
Variablenwerte benutzt wird, numerische Optionen, Ablaufverfol- 
gungsoptionen und Host-AdreBzeichenfolgen. Wahrend der Pro- 
grammausfuhrung kann es nur eine globale Umgebung, aber 
mehrere Speicherumgebungen geben. Bei jedem Aufruf einer 
internen Funktion wird eine neue Speicherumgebung aktiviert und 
initialisiert. Die Ausgangswerte fur die meisten Felder werden aus 
der vorherigen Umgebung ubernommen. Werte konnen jedoch 
spater geandert werden, ohne daB sich dies auf die Umgebung der 
Aufrufebene auswirkt. Die neue Umgebung bleibt so lange 
bestehen, bis die Funktion die Steuerung zuriickgibt. 

Zu jeder Speicherumgebung gehort eine Symboltabelle. Sie dient 
zum Speichern der Wertzeichenfolgen, die den Variablen zuge- 
wiesen werden. Diese Symboltabelle ist in Form eines aus zwei 
Ebenen bestehenden, binaren Baums aufgebaut. Die Primarebene 
speichert Eintrage fur einfache Symbole und Stammsymbole, die 
Sekundarebene wird fur zusammengesetzte Symbole verwendet. 
Alle zusammengesetzten Symbole, die den gleichen Stamm besitzen, 
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werden in einem Baum gespeichert, wobei der Eintrag fur den 
Stamm die Wurzel des Baumes bildet. 

Symbole werden erst nach einer erfolgten Zuweisung in die Tabelle 
aufgenommen. Einmal auf der Primarebene erstellte Eintrage 
werden niemals geloscht, selbst wenn die Initialisierung des 
Symbols spater riickgangig gemacht wird. Sekundare Baume 
werden freigegeben, wenn eine Zuweisung an den zu diesem Baum 
gehbrenden Stamm erfolgt. 



3.5.3 Betriebsmittelverwaltung 

ARexx bietet eine vollstandige Verwaltung aller dynamisch zuge- 
ordneten Betriebsmittel (Resource-Tracking), die zur Ausfuhrung 
eines Programms verwendet werden. Zu diesen Ressourcen zahlen 
Speicherplatz, DOS-Dateien und verwandte Strukturen sowie die 
Message-Port-Struktur. Dieses Verwaltungssystem ist so ausgelegt, 
dafi bei einem Programmabbruch zu einem beliebigen Zeitpunkt 
keine blockierten Betriebsmittel zuruckgelassen werden. 

Durch direkte Aufrufe des Amiga-Betriebssystems von einem 
ARexx-Programm aus ist es moglich, das System der Betriebs- 
mittelverwaltung des Interpreters zu libergehen. In diesem Fall ist 
es Aufgabe des Programmierers, alle Betriebsmittel, die sich 
auBerhalb des ARexx-Betriebsmittelverwaltungssystems befinden, 
zu kontrollieren und zuriickzugeben. ARexx bietet eine spezielle 
Interrupt-Einrichtung, so daB ein Programm nach einem Aus- 
fiihrungsfehler die Steuerung behalten, die erforderliche 
Bereinigung ausfiihren und ordnungsgemafi beendet werden kann. 



Kapitel4 

Befehle 



Eine Befehlsklausel beginnt mit dem Namen eines bestimmten 
Befehls und weist ARexx an, eine bestimmte Aktion auszufiihren. 
Dieses Kapitel enthalt eine Liste der in ARexx verfugbaren Befehle. 

Auf jedes Befehlsschliisselwort konnen ein oder mehrere Unter- 
schliisselworter, Ausdriicke oder andere befehlsspezifische Infor- 
mationen folgen. Befehlsschllisselworter und Unterschliisselworter 
werden nur in diesem spezifischen Kontext als solche erkannt. 
Daher ist es moglich, die gleichen Schliisselwbrter in verschiedenen 
Kontexten als Variablen oder Funktionsnamen zu verwenden. Auf 
ein Befehlsschliisselwort darf keiner der Operatoren Doppelpunkt 
(:) oder Gleichheitszeichen (=) folgen. 
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4. 1 Syntax 



Die Syntax jeder Anweisung steht jeweils rechts vom Schliisselwort 
in der Uberschrift. Tabelle 4-1 zeigt die in den Syntaxangaben 
geltenden Konventionen: 

Tabelle 4-1. Syntaxkonventionen 

Konvention Definition 

SCHLUSSELWORT Alle Schlusselworter und Unterschlusselworter 
sind in GroBbuchstaben geschrieben 

ausdruck Erforderliche Argumente sind in Kleinbuchstaben 

geschrieben 

I (senkrechter Alternative Auswahlmoglichkeiten sind durch 

Strich) einen senkrechten Strich voneinander (bzw. von 

der Standardauswahl) getrennt 

{} (geschweifte Erforderliche Alternativen stehen in geschweiften 

Klammern) Klammern 

[] (eckige Wahlweise verwendbare Befehlsteile stehen in 

Klammern) eckigen Klammern 

Der Befehl CALL hat z. B. folgendes Format: 

CALL {Symbol I Zeichenf olge} [Ausdruck] 
[ , Ausdruck, . . . ] 

Als Argument miissen Sie ein Symbol oder eine Zeichenfolge 
angeben. Der senkrechte Strich kennzeichnet Alternativen, 
zwischen denen gewahlt werden kann. Die geschweiften Klammern 
bedeuten, dafl ein Argument in jedem Fall erforderlich ist. Die 
Angabe eines Ausdrucks ist nicht zwingend erforderlich, was Sie an 
den eckigen Klammern erkennen konnen. 

Am Ende jeder Befehlsbeschreibung ist jeweils ein Beispiel 
angegeben. Erlauterungen oder Bewertungen der Beispiele finden 
Sie in Form von ARexx-Kommentarzeilen (/*... */). 
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4.2 Befehle in alphabetischer 
Reihenfolge 

Dieser Abschnitt enthalt eine Liste integrierter ARexx-Befehle in 
alphabetischer Reihenfolge. Die Syntax jedes Befehls sehen Sie 
jeweils rechts vom Befehlsschlusselwort. 

ADDRESS ADDRESS [[Symbol I Zeichenfolge] I [WERT][Ausdr.]] 

Dieser Befehl gibt eine Host-Adresse fur vom Interpreter 
ausgegebene Kommandos an. Unter einer Host-Adresse versteht 
man den Namen des Message-Ports einer Anwendung, an den 
ARexx-Kommandos gesendet werden. ARexx verwaltet zwei Host- 
Adressen: einen aktuellen und einen vorhergehenden Wert. Immer 
wenn Sie eine neue Host-Adresse angeben, wird diese zum 
aktuellen Wert und die bisher aktuelle Adresse zur vorher- 
gehenden. Der bis dahin vorhergehenden Wert wird geloscht. Die 
Host-Adressen sind Bestandteil der Speicherumgebung eines 
Programms und iiberdauern auch interne Funktionsaufrufe. Die 
aktuelle Adresse kann mit der integrierten Funktion ADDRESSO 
aufgerufen werden. 

Das Schliiselwort ADDRESS - alleine angegeben - schaltet vom 
aktuellen auf den vorhergehenden Host um, bei wiederholter 
Ausfuhrung wiirde also zwischen den zwei Host-Adressen hin- und 
hergeschaltet. 

ADDRESS (Zeichenfolge I Symbol) macht die/das angegebene 
Zeichenfolge/Symbol zur neuen Host-Adresse. Der Wert der 
Zeichenfolge bzw. des Symbols ist also das Token selbst. Bei Namen 
von Message-Ports wird zwischen GroB- und Kleinschreibung unter- 
schieden. Ein Programmkommando an den Message-Port MeinPort 
muflte also wie folgt aussehen: 

ADDRESS 'MeinPort ' 

Werden die einfachen Anfuhrungszeichen weggelassen, sucht 
ARexx nach dem Message-Port MEINPORT und gibt eine Fehler- 
meldung aus. Die aktuelle Host-Adresse wird zur vorhergehenden. 
Ein auf die Zeichenfolge bzw. das Symbol folgender Ausdruck wird 
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ausgewertet, das Ergebnis wird an den angegebenen Host gesendet. 
Aktuelle und vorhergehende Adresse bleiben unverandert. Auf diese 
Weise kann ein einzelnes Kommando an einen externen Host 
ausgegeben werden, ohne daB die Host-Adressen davon beriihrt 
werden. Der Riickgabewert des Kommandos wird behandelt wie der 
einer Kommandoklausel. 

Bei Angabe von ADDRESS [VALUE] Ausdruck verwendet ARexx 
das Resultat des Ausdrucks als neue Host-Adresse (d. h. die bisher 
aktuelle Adresse wird zur vorhergehenden). Das Schlusselwort 
VALUE kann weggelassen werden, wenn das erste Token des 
Ausdrucks weder ein Symbol noch eine Zeichenfolge ist. Beispiel: 

ADDRESS /*Wechsel zwischen aktueller und 

vorhergehender Adresse.*/ 
ADDRESS edit *Die neue Host-Adresse lautet EDIT.*/ 

ADDRESS edit 'top' /*An den Anfang gehen.*/ 

ADDRESS VALUE edit in /*Eine neue Host-Adresse 

berechnen. */ 



ARG ARG [Schablone] [,Schablone ...] 

ARG ist eine Kurzform des Befehls PARSE UPPER ARG. Damit 
konnen eine oder mehrere dem Programm zur Verfugung stehende 
Argumentzeichenfolgen abgerufen und den Variablen in der 
Schablone zugeordnet werden. Die Anzahl der verfiigbaren 
Argumentzeichenfolgen hangt davon ab, ob das Programm als 
Kommando oder als Funktion aufgerufen wurde. Kommandoaufrufe 
verfugen in der Regel nur iiber eine Argumentzeichenfolge, 
Funktionen konnen dagegen bis zu 15 aufweisen. Die 
Argumentzeichenfolgen werden durch den Befehl ARG nicht 
verandert. ARG gibt GroBbuchstaben zuriick. Beispiel: 

ARG erstes, zweites /* Argument e abruf en*/ 

Struktur und Verarbeitung von Schablonen werden im Abschnitt 
zum Befehl PARSE auf Seite 4-15 kurz beschrieben. 
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BREAK BREAK 

Der Befehl BREAK dient dazu, den Bereich eines DO-Befehls oder 
einer INTERPRETierten Zeichenfolge zu verlassen. Er ist nur in 
einem solchen Kontext giiltig. Wird er innerhalb einer DO- 
Anweisung verwendet, wird die innerste DO-Anweisung, die den 
Befehl BREAK enthalt, verlassen. Im Gegensatz dazu wird mit dem 
verwandten Befehl LEAVE nur eine iterative (d. h. sich 
wiederholende) DO-Anweisung verlassen. Beispiel: 

DO /*Block beginnen*/ 

IF a>3 THEN BREAK /*Fertig?*/ 
a = a + 1 
y . a = name 
END /*Block beenden*/ 



CALL CALL {Symbol I Zeichenfolge) [Ausdruck] [,Ausdruck, .„] 

Der Befehl CALL dient zum Aufrufen einer internen oder externen 
Funktion. Der Funktionsname wird durch das Symbol- oder 
Zeichenfolge-Token angegeben. Alle darauf folgenden Ausdriicke 
werden ausgewertet und werden zu Argumenten der aufgerufenen 
Funktion. Der von der Funktion zuruckgegebene Wert wird der 
Sondervariablen RESULT zugeordnet. Es gilt nicht als Fehler, 
wenn keine Ergebniszeichenfolge zuriickgegeben wird. In diesem 
Fall wird die Variable RESULT geloscht, d. h. ihre Initialisierung 
wird mittels der Anweisung DROP riickgangig gemacht. 

Die Verbindung zur Funktion wird zum Zeitpunkt des Aufrufs 
dynamisch hergestellt. Bei der Suche nach einer aufgerufenen 
Funktion halt ARexx eine bestimmte Reihenfolge ein. Beispiel: 

CALL CENTER name , laenge+4 , ' + ' 

CENTER ist die aufgerufene Funktion. Die Ausdriicke werden 
ausgewertet und als Argumente an CENTER weitergeleitet. 
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DO DO [[Var=Ausdr] I [Ausdr] [TO Ausdr] [BY Ausdr]] 

[FORAusdr] [FOREVER] [WHILE Ausdr I UNTIL Ausdr] 

Mit der Anweisung DO wird eine Befehlsgruppe eingeleitet, die als 
zusammengehoriger Block ausgefuhrt wird. Der Bereich des Befehls 
DO umfafit alle Anweisungen bis zu und einschlieBlich eines 
moglichen Befehls END. 

Wenn auf den Befehl DO kein Unterschliisselwort folgt, wird der 
Block einmal ausgefuhrt. Durch Angabe von Unterschlusselwortern 
kann die Ausfuhrung eines Blocks wiederholt werden, bis eine 
Endebedingung eintritt. Eine iterative (wiederholte) DO-Anweisung 
wird manchmal auch als Schleife (engl. loop) bezeichnet, da ARexx 
sozusagen mit einem "Looping" an eine bereits durchlaufene Stelle 
im Programm zuriickkehrt, um einen Befehl nochmals auszufiihren. 
Der Befehl DO setzt sich aus folgenden Komponenten zusammen: 

• Ein Initialisierungsausdruck im Format "Variable=Ausdruck" 
definiert die Indexvariable der Schleife. Der Ausdruck wird 
ausgewertet, wenn der Bereich des Befehls DO erstmals 
aktiviert wird. Das Ergebnis wird der Indexvariablen 
zugeordnet. Bei folgenden Wiederholungen (Iterationen) wird 
ein Ausdruck im Format "Variable = Variable + Inkrement" 
ausgewertet, wobei das Inkrement (die Zunahme) das Ergebnis 
des Ausdrucks BY ist. Wird ein Initialisierungsausdruck ange- 
geben, mufl er alien anderen Unterschlusselwortern voraus- 
gehen. 

• Der auf ein Symbol BY folgende Ausdruck definiert das 
Inkrement, das bei jeder folgenden Iteration zur Indexvariablen 
addiert wird. Der Ausdruck muB ein numerisches Resultat 
ergeben, das positiv oder negativ sein kann und keine ganze 
Zahl sein muB. Das Standardinkrement ist 1. 

• Das Resultat des Ausdrucks nach TO legt die obere (oder 
untere) Grenze fur die Indexvariable fest. Bei jeder Iteration 
wird die Indexvariable mit dem Ergebnis von TO verglichen. Ist 
das Inkrement (Resultat von TO) positiv und die Variable 
grofler als der Grenzwert, bricht der Befehl DO ab und iibergibt 
die Steuerung an die auf den Befehl END folgende Anweisung. 
Die Schleife wird auch beendet, wenn das Inkrement negativ ist 
und die Indexvariable unter dem TO-Grenzwert liegt. 
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• Der Ausdruck nach FOR muB bei der Auswertung eine positive 
ganze Zahl ergeben. Er legt die maximale Anzahl der 
auszufuhrenden Iterationen fest. Die Schleife wird beendet, 
sobald dieser Grenzwert erreicht ist, unabhangig vom Wert der 
Indexvariablen. 

Die Initialisierungsausdriicke BY, TO und FOR werden nur bei 
der ersten Aktivierung des Befehls ausgewertet; damit bleiben 
das Inkrement und die Grenzwerte wahrend der gesamten 
Ausfuhrung unverandert. Ein Grenzwert ist nicht unbedingt 
erforderlich. So kann z. B. mit dem Befehl "DO i=l" ein 
Zahlvorgang unbegrenzt lange weiterlaufen. 

Das Schlusselwort FOREVER kann verwendet werden, wenn 
ein iterativer DO-Befehl gebraucht wird, aber keine 
Indexvariable notwendig ist. Die Schleife kann durch einen in 
der Schleife enthaltenen Befehl LEAVE oder BREAK beendet 
werden. 

• Der Ausdruck nach WHILE wird am Anfang jeder Iteration 
ausgewertet und muB einen booleschen Wert ergeben. Die 
Iteration wird bei Resultat 1 (oder "wahr") fortgesetzt. 
Andernfalls wird der Schleifendurchlauf beendet. 

• Der Ausdruck nach UNTIL wird am Ende jeder Iteration 
ausgewertet und muB einen booleschen Wert ergeben. Der 
Befehl wird mit der nachsten Iteration fortgesetzt, wenn das 
Resultat (oder "falsch") lautet, andernfalls wird er 
abgebrochen. (WHILE und UNTIL schlieBen sich gegenseitig 
aus.) 

Programm 12. Iteration.rexx 

/*Beispiele fur DO*/ 

LIMIT = 20; nummer = 1 

DO i=l to LIMIT for 10 WHILE nummer < 20 

nummer = i * nummer 

SAY "Iteration" i "nummer=" nummer 

END 
nummer = nummer /3 . 345 ; i = 
DO nummer for LIMIT/ 5 

i = i + 1 

SAY "Iteration" i-"nummer=" nummer 

END 
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Die Ausgabe wird hier mit erlauternden Kommentarzeilen gezeigt, 
die am Bildschirm naturlich nicht erscheinen wiirden. 



Iterati 

Iterati 

Iterati 

Iterati 

Iterati 

7.17488 

Iterati 

gleich 

Iterati 

4 */ 

Iterati 

mal wie 

Hinweis 



on 1 Nummer 



on 
on 

on 



Nummer 
Nummer 
Nummer 

on 1 Nummer 

789 */ 

on 2 Nummer 

*/ 

on 3 Nummer 

on 4 Nummer 
derholt */ 



1 /* 1 * 1 = 1 */ 

2 /* 2 * 1 = 2 */ 
6 /* 3 * 2 = 6 */ 

24 /*4 * 6 = 24 */ 

7.17488789 /* 24/3.345 = 

7.17488789 /* Nummer bleibt 

7.17488789 /* limit/5 - 20/5 = 

7.17488789 /* Operation wird 4 



1st auch ein FOR-Grenzwert vorhanden, wird der 
ursprungliche Ausdruck dennoch ausgewertet, muB aber 
keine positive ganze Zahl ergeben. 



DROP 



DROP Variable [Variable ...] 



Die angegebenen Variablensymbole werden auf den Stand vor ihrer 
Initialisierung rlickgesetzt. Auf diesem Stand entspricht der Wert 
der Variablen dem Variablennamen selbst. Es liegt kein Fehler vor, 
wenn eine Variable, die nicht mehr initialisiert ist, mit dem Befehl 
DROP geloscht wird. Wird ein Stammsymbol mit DROP geloscht, 
werden damit auch die Werte aller vom Stammsymbol abgeleiteten 
zusammengesetzten Symbole geloscht. Beispiel: 

a = 12 3 /*a einen Wert zuordnen */ 

DROP a b /*Werte von A und B loschen (mit DROP)*/ 

SAY a b /*Resultat ist: A B.*/ 



ECHO 



ECHO [Ausdruck] 



Der Befehl ECHO ist gleichbedeutend mit dem Befehl SAY. Er zeigt 
das Ergebnis des Ausdrucks am Konsolenbildschirm an. Beispiel: 

ECHO "Was Du nicht sagst ! " 



Befehle 4-9 



ELSE ELSE [;] I bedingte Anweisung] 

Der Befehl ELSE leitet den alternativen bedingten Zweig einer IF- 
Anweisung ein. Er ist nur innerhalb des Bereichs eines IF-Befehls 
giiltig und muB auf die bedingte Anweisung des THEN-Zweiges 
folgen. Wurde der THEN-Zweig nicht ausgefuhrt, wird die auf die 
Klausel ELSE folgende Anweisung verarbeitet. 

ELSE-Klauseln beziehen sich stets auf die unmittelbar davor 
befindliche IF-Anweisung. In manchen Fallen ist es notwendig, 
"Pseudo" ELSE-Klauseln fur die inneren IF-Bereiche mehrerer 
verschachtelter IF-Anweisungen anzugeben, damit auch die 
auBeren IF-Anweisungen iiber alternative Verzweigungen verfugen 
kbnnen. Es geniigt nicht, die ELSE-Anweisung mit einem 
Semikolon oder einer Null-Klausel abzuschlieBen. Stattdessen kann 
der Befehl NOP (No-operation) verwendet werden. Beispiel: 

IF i > 2 THEN SAY ' Tatsachlich? ' 
ELSE SAY ' Habe ich mir gedacht ' 



END END [Variable] 

Der Befehl END schlieBt den Bereich eines DO- oder SELECT- 
Befehls ab. Wenn das wahlfreie Variablensymbol angegeben wird, 
wird es mit der Indexvariablen der DO-Anweisung verglichen (die 
iterativ sein muB). Stimmen die Symbole nicht uberein, kommt es 
zu einem Fehler. Beispiel: 

DO i=l to 5 /*Indexvariable ist i*/ 
SAY i 
END i /^'i*' -Schleife beenden*/ 



EXIT EXIT [Ausdruck] 

Der Befehl EXIT beendet die Ausfuhrung eines Programms. Er ist 
an jeder beliebigen Stelle in einem Programm giiltig. Der 
ausgewertete Ausdruck wird als Ergebnis der Funktion oder des 
Kommandos an die Aufrufebene zuriickgegeben. 

Die Verarbeitung des EXIT-Ergebnisses hangt davon ab, ob das 
aufrufende Programm eine Ergebniszeichenfolge angefordert hat 
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und ob der aktuelle Aufruf aus einem Kommando- oder 
Funktionsaufruf hervorging: 

• Wurde eine Ergebniszeichenfolge angefordert, wird das 
Ergebnis des Ausdrucks in einen eigens reservierten 
Speicherblock kopiert. Ein Verweiszeiger auf diesen Block wird 
als Sekundarergebnis dieses Aufrufs zuriickgegeben. 

• Forderte dagegen die Aufrufebene keine Ergebniszeichenfolge 
an und wurde das Programm als Kommando aufgerufen, wird 
versucht, das Ergebnis des Ausdrucks in eine ganze Zahl 
umzuwandeln. Dieser Wert wird dann als Primarergebnis zu- 
riickgegeben. Das Sekundarergebnis ist in diesem Falle 0. Auf 
diese Weise konnen die EXIT-Informationen von der Aufruf- 
ebene als Riickgabewert interpretiert werden. 

Beispiel: 

EXIT /*Kein Ergebnis erf order lien* / 

EXIT 10 /*Eine Fehlerruckmeldung*/" 



IF IF Ausdruck [THEN] [;] [bedingte Anweisung] 

Der Befehl IF wird in Verbindung mit den Befehlen THEN und 
ELSE zur bedingten Ausfuhrung einer Anweisung verwendet. Das 
Ergebnis des Ausdrucks mui3 ein boolescher Wert sein. Ist das 
Ergebnis 1 ("Wahr"), wird die auf das Symbol THEN folgende 
Anweisung ausgefuhrt. Andernfalls geht die Steuerung an die 
nachste Anweisung iiber. Das Schliisselwort THEN muB nicht 
unmittelbar auf den IF-Ausdruck folgen, sondern kann auch als 
separate Klausel vorliegen. 

Der Befehl wird als "IF Ausdruck; THEN; Anweisung." analysiert. 
Der Ausdruck, der auf die IF-Anweisung folgt, stellt die 
Testbedingung dar, die entscheidet, ob im folgenden die Klausel 
THEN oder ELSE ausgefuhrt wird. Auf das Symbol THEN kann 
eine beliebige giiltige Anweisung folgen. Insbesondere ermoglicht 
ein Block "DO . . . END;" die bedingte Ausfuhrung mehrerer 
Anweisungen. Beispiel: 

IF result < THEN exit /*Alles erledigt?*/ 
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INTERPRET INTERPRET Ausdruck 

Das Kommando INTERPRET behandelt den Ausdruck wie einen 
Block von Quellenanweisungen. Der Ausdruck wird ausgewertet, 
und das Ergebnis wird wie eine oder mehrere Programm- 
anweisungen ausgefuhrt. Die Anweisungen werden als Block 
betrachtet, so als ob sie von "DO . . . END" umschlossen waren. Jede 
beliebige Anweisung kann in dem INTERPRETierten Quelltext 
enthalten sein, einschliefllich der Befehle DO und SELECT. Der 
Befehl BREAK kann zur Beendigung der Verarbeitung 
INTERPRETierter Anweisungen eingesetzt werden. 

Ein INTERPRET-Befehl aktiviert bei seiner Ausfuhrung einen 
Steuerbereich, der als Begrenzung fur die Befehle LEAVE und 
ITERATE dient. Diese Befehle konnen nur in DO-Schleifen 
verwendet werden, die innerhalb von INTERPRET definiert 
wurden. Es ist zwar kein Fehler, wenn Sprungmarkenklauseln 
innerhalb der interpretierten Zeichenfolge stehen. Zur Ubertragung 
der Steuerung wird jedoch nur unter denjenigen Sprungmarken 
gesucht, die im Originalprogramm definiert wurden. 

Der Befehl INTERPRET kann zur dynamischen Gestaltung und 
Ausfuhrung von Programmen verwendet werden. Programmfrag- 
mente konnen als Argumente an Funktionen weitergegeben 
werden, die dann die Fragmente INTERPRETieren. Beispiel: 

bef = 'SAY 1 /*Ein Befehl*/ 

INTERPRET bef hallo /*. . . "SAY HALLO"*/ 



ITERATE ITERATE [Variable] 

Der Befehl ITERATE beendet die aktuelle Iteration (den 
Schleifendurchlauf) eines DO-Befehls und startet die nachste 
Iteration. Effektiv bedeutet dies, dafi die Steuerung an die END- 
Anweisung und anschlieBend (abhangig vom Ergebnis des 
Ausdrucks UNTIL) wieder zurlick an die DO-Anweisung libertragen 
wird. Der Befehl wirkt sich normalerweise auf den innersten 
iterativen DO-Bereich aus. Wenn sich der Befehl ITERATE nicht 
innerhalb eines iterativen DO-Befehls befindet, kommt es zu einem 
Fehler. 
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Falls mehrere verschachtelte Bereiche existieren, bestimmt das 
wahlfreie Variablensymbol, welcher DO-Bereich verlassen werden 
soil. Die Variable wird als Literal gelesen und muB mit der 
Indexvariablen eines gegenwartig aktiven DO-Befehls iiberein- 
stimmen. Wenn kein entsprechender DO-Befehl gefunden wird, 
kommt es zu einem Fehler. Beispiel: 

DO i=l to 5 

IF i = 3 THEN ITERATE i 

SAY i, 

END 



LEAVE LEAVE [Variable] 

LEAVE fuhrt zum sofortigen Verlassen des iterativen DO-Bereichs, 
der diesen Befehl enthalt. Befindet sich der Befehl LEAVE nicht 
innerhalb eines iterativen DO-Befehls, kommt es zu einem Fehler. 
Falls mehrere verschachtelte Bereiche existieren, bestimmt das 
wahlfreie Variablensymbol, welcher DO-Bereich verlassen werden 
soil. Die Variable wird als Literal gelesen und muB mit der 
Indexvariablen eines gegenwartig aktiven DO-Befehls liberein- 
stimmen. Wenn kein entsprechender DO-Befehl gefunden wird, 
kommt es zu einem Fehler. Beispiel: 

DO i = 1 to limit 

IF i > 5 THEN LEAVE /*Maximale IterationenV 

END 



NOP NOP 

Der Befehl NOP (keine Operation, engl. no operation) dient zur 
Anbindung von ELSE-Klauseln an verschachtelte IF-Anweisungen. 
Beispiel: 

IF i = j THEN /*Erstes (aufieres) IF*/ 

IF j = k THEN a = /*Inneres IF*/ 

ELSE NOP /*Anbindung ans innere IF*/ 

ELSE a = a + 1 /*Anbindung ans auiSere IF*/ 
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NUMERIC NUMERIC {DIGITS I FUZZ) Ausdruck NUMERIC 

FORM {SCIENTIFIC I ENGINEERING) 

• Der Befehl NUMERIC dient zur Einstellung von Optionen, die 
sich auf die numerische Genauigkeit und das Format beziehen. 
Die numerischen Optionen bleiben bei Aufruf einer internen 
Funktion erhalten. 

• Die Ausdrucksoption DIGITS legt die Anzahl geltender Stellen 
fur die Genauigkeit bei arithmetischen Berechnungen fest. Der 
Ausdruck muB bei der Auswertung eine positive ganze Zahl 
ergeben. 

Die Ausdrucksoption FUZZ legt die Anzahl geltender Stellen 
fest, die bei numerischen Vergleichsoperationen ignoriert 
werden sollen. Hierbei muB es sich um eine positive ganze Zahl 
handeln, die kleiner ist als die derzeitig aktuelle Option 
DIGITS. 

• Die Option FORM SCIENTIFIC legt zur Exponentialdarstellung 
von Zahlen die wissenschaftliche Schreibweise fest. Der 
Exponent wird angepaBt, so daB die Mantisse (bei Zahlen 
ungleich Null) im Bereich von 1 bis 9 liegt. Dies ist das 
Standardformat. 

. Die Option FORM ENGINEERING wahlt zur Exponential- 
darstellung von Zahlen die technische Schreibweise. Dabei wird 
eine Zahl normalisiert, so daB ihr Exponent ein Vielfaches von 
drei ist und die Mantisse (falls ungleich Null) im Bereich von 1 
bis 999 liegt. 

NUMERIC DIGITS 12 /*Auf 12 Ziffern genauV 
NUMERIC FORM SCIENTIFIC /*Resultat in 
wissenschaftlicher Schreibweise*/ 
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OPTIONS OPTIONS [FAILAT Ausdruck] 

OPTIONS [PROMPT Ausdruck] 

OPTIONS [RESULTS] 

OPTIONS [CACHE] 

Der Befehl OPTIONS dient zum Setzen verschiedener interner 
Standardwerte. Der Ausdruck nach FAILAT setzt den Grenzwert, 
bei dessen Erreichen oder Uberschreiten Riickgabewerte von 
Kommandos als Fehler angesehen werden. Die Auswertung des 
Ausdrucks muB eine ganze Zahl ergeben. Der Ausdruck nach 
PROMPT legt eine Zeichenfolge fest, die bei dem Befehl PULL (oder 
PARSE PULL) als Eingabeaufforderung verwendet wird. Das 
Schlusselwort RESULTS gibt an, daB der Interpreter eine 
Ergebniszeichenfolge anfordern soil, wenn er Kommandos an einen 
externen Host ausgibt. 

Die iiber diesen Befehl gesteuerten internen Optionen bleiben auch 
iiber Funktionsaufrufe hinweg erhalten, d. h. ein Befehl OPTIONS 
kann innerhalb einer internen Funktion gegeben werden, ohne 
dadurch die Umgebung der Aufrufebene zu beeinflussen. Wird kein 
Schlusselwort zum Befehl OPTIONS angegeben, nehmen alle 
genannten Optionen wieder ihre Standardwerte an. Der Befehl 
OPTIONS akzeptiert auch das Schlusselwort NO, um eine 
ausgewahlte Option auf ihren Standardwert riickzusetzen. Dies 
erleichtert es beispielsweise, das Attribut RESULTS fur ein 
einzelnes Kommando riickzusetzen, ohne zusatzlich auch die 
Optionen FAILAT und PROMPT riicksetzen zu mussen. 

OPTIONS akzeptiert auch das Schlusselwort CACHE, das zur 
Aktivierung/Inaktivierung eines internen Cache zur Zwischen- 
speicherung von Anweisungen dient. Normalerweise ist der Cache 
aktiviert. Beigpiel: 

OPTIONS FAILAT 10 

OPTIONS PROMPT "Ja, Chef?" 

OPTIONS RESULTS 
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OTHERWISE OTHERWISE [;] [bedingte Anweisung] 

Dieser Befehl ist nur im Bereich eines SELECT-Befehls giiltig und 
mufl am SchluB aller "WHEN . . . THEN M -Anweisungen folgen. War 
keine der vorherigen WHEN-Klauseln zutreffend, wird die auf den 
Befehl OTHERWISE folgende Anweisung ausgefuhrt. In einem 
SELECT-Bereich ist ein OTHERWISE nicht unbedingt erforderlich. 
Allerdings kommt es zu einem Fehler, wenn die Klausel 
OTHERWISE weggelassen wird und keiner der WHEN-Befehle 
zutrifft. Beispiel: 

SELECT 

WHEN i=l THEN say ' eins ' 
WHEN i=2 THEN say ' zwei * 
OTHERWISE SAY ' andere ' 
END 



PARSE PARSE [UPPER] Eingabequelle [Schablone] [,Schablone ...] 

Der Befehl PARSE bietet einen Mechanismus zum Extrahieren 
einer oder mehrerer Teilzeichenfolgen aus einer Zeichenfolge und 
zum Zuweisen dieser Extrakte an Variablen. Die Eingabezeichen- 
folge kann aus verschiedenen Quellen stammen, z. B. aus Argu- 
mentzeichenfolgen, aus einem Ausdruck oder von der Konsole. 

Die Syntaxanalyse (engl. Parsing) wird iiber eine Schablone 
gesteuert, die sich aus Symbolen, Zeichenfolgen, Operatoren und 
Klammern zusammensetzen kann. Die Schablone gibt sowohl die 
Variablen an, denen Werte zugewiesen werden sollen, als auch die 
Art der Begrenzung der Wertzeichenfolgen. Wahrend des 
Analysevorgangs wird die Zeichenfolge in Unterzeichenfolgen 
aufgeteilt, die dann den Variablensymbolen in der Schablone 
zugeordnet werden. Der ProzeB dauert an, bis alien Variablen in 
der Schablone ein Wert zugeordnet wurde. Wenn die Eingabe- 
zeichenfolge vorher "aufgebraucht" ist, erhalten die verbleibenden 
Variablen Nullwerte. 

Wenn auf eine Variable in der Schablone unmittelbar eine weitere 
Variable folgt, wird die Wertzeichenkette durch Aufspalten der 
Eingabezeichenfolge in Worter (getrennt durch Leerzeichen) 
festgelegt. Flihrende und abschlieBende Leerzeichen sind nicht 
zulassig. Jedes Wort wird einer Variablen in der Schablone 
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zugewiesen. Normalerweise erhalt dabei die letzte Variable den 
nicht tokenisierten Rest der Eingabezeichenfolge, da auf sie kein 
Symbol folgt. Ein Platzhaltersymbol, ein Punkt (.), fuhrt dazu, dafl 
die Variable mit dem Punkt endet, sobald ein Leerzeichen im 
Eingabestrom vorkommt. Platzhalter verhalten sich wie Variablen, 
allerdings wird ihnen niemals ein Wert zugewiesen. 

Die Schablone kann weggelassen werden, wenn der Befehl nur zur 
Auswertung einer Eingabezeichenfolge vorgesehen ist. Schablonen 
werden in Kapitel 7.1 beschrieben. 

Das Ziel der Analyseoperation ist es, fur jedes Variablensymbol in 
der Schablone einen Bezug zu einer aktuellen und einer nachsten 
Position herzustellen. Die Unterzeichenfolge zwischen diesen 
Positionen wird dann der Variablen als Wert zugeordnet: 

Im folgenden finden Sie eine Beschreibung der verschiedenen 
Optionen zu diesem Befehl: 

Das wahlfreie Schliisselwort UPPER kann mit jeder 
Eingabequelle verwendet werden und bedeutet, dafl die 
Eingabe-zeichenfolge vor der Analyse in GroBbuchstaben 
umgewandelt werden soil. UPPER muB das erste Token sein, 
das auf PARSE folgt. 

• Die Quellen fur die Eingabezeichenfolgen werden durch die im 
folgenden erlauterten Schliisselwortsymbole festgelegt. Bei 
Angabe mehrerer Schablonen empfangt jede Schablone eine 
neue Eingabezeichenfolge, auch wenn bei manchen 
Quellenoptionen die neue Zeichenfolge mit der vorherigen 
identisch ist. Die Zeichenfolge der Eingabequelle wird vor der 
Syntaxanalyse kopiert, d. h. die Originalzeichenfolgen werden 
durch den Analy-seprozefl nicht verandert. 

• Die Eingabeoption ARG ruft die Argumentzeichenfolgen ab, die 
beim Aufiruf des Programms abgerufen wurden. Kommando- 
aufrufe weisen in der Regel nur eine einzige Argument- 
zeichenfolge auf, Funktionen dagegen bis zu 15. 

• Die Eingabezeichenfolge EXTERNAL wird aus dem STDERR- 
Strom gelesen (siehe Kapitel 6.1.1), um zu vermeiden, dafl 
PUSH- oder QUEUE-Daten verandert werden. Bei Angabe 
mehrerer Schablonen liest jede Schablone eine neue 
Zeichenfolge. Diese Quellenoption entspricht der Option PULL. 
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• Die Eingabeoption NUMERIC stellt die aktuellen numerischen 
Optionen in eine Zeichenfolge, und zwar in der Reihenfolge 
DIGITS, FUZZ und FORM, jeweils getrennt durch ein einzelnes 
Leerzeichen. 

Die Eingabeoption PULL liest eine Eingabeoption von der 
Eingabekonsole. Bei Angabe mehrerer Schablonen liest jede 
Schablone eine neue Zeichenfolge. 

• Die Eingabeoption SOURCE ruft die Quellenzeichenfolge fur 
das Programm ab. Die Zeichenfolge wird wie folgt formatiert: 

{COMMAND! FUNCTION} { J 1 } AUFGERUFEN AUFGELOST ERW 
HOST 

Die einzelnen Komponenten haben folgende Bedeutung: 

- {COMMAND I FUNCTION} gibt an, ob das Programm als 
Kommando oder als Funktion aufgerufen wurde. 

{0 I 1) ist ein boolesches Kennzeichen und gibt an, ob eine 
Ergebniszeichenfolge von der Aufrufebene angefordert 
wurde. 

AUFGERUFEN steht fur den Namen, unter dem dieses 
Programm aufgerufen wurde. 

AUFGELOST bezeichnet den endgultigen Namen des 
Programms (nach der Auflosung). 

ERW steht fur die bei Suchoperationen zu verwendende 
Dateinamenserweiterung (Standardwert ist "REXX"). 

HOST gibt die ursprungliche Host-Adresse fur Kommandos 
an. 

Die Option SOURCE gibt nun den vollstandigen Pfadnamen der 
ARexx-Programmdatei zuriick. Zuvor wurde lediglich ein relativer 
Namen angegeben, was zur Lokalisierung der Quelldatei des Pro- 
gramms nicht ausreichte. 

Die Eingabezeichenfolge "VALUE Ausdruck WITH" ist Ergebnis des 
angegebenen Ausdrucks. Das Schliisselwort WITH ist erforderlich, 
um den Ausdruck von der Schablone zu trennen. Das Resultat des 
Ausdrucks kann durch die Verwendung mehrerer Schablonen 
mehrmals analysiert werden, der Ausdruck selbst wird dagegen 
nicht neu ausgewertet. 
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Die Eingabeoption "VAK Variable" verwendet den Wert der 
angegebenen Variable als Eingabezeichenfolge. Bei Verwendung 
mehrerer Schablonen verwendet jede Schablone den aktuellen Wert 
der Variablen. Dieser Wert kann sich andern, wenn die Variable zu 
den Zuweisungszielen in einer der Schablonen gehort. 

Die Eingabeoption VERSION der aktuellen Konfiguration des 
ARexx-Interpreters wird im folgenden Format angegeben: 

ARexx VERSION CPU MPU VIDEO FREQ 

die einzelnen Komponenten haben folgende Bedeutung: 

• VERSION ist die Versionsnummer des Interpreters im Format 
wie 1.15. 

• CPU bezeichnet den Prozessor, der das Prdgramm gegenwartig 
ausfuhrt. Moglich sind folgende Werte: 68000, 68010, 68020, 
68030, 68040. 

• MPU ist entweder NONE, 68881 oder 68882, abhangig davon, 
ob ein mathematischer Koprozessor vorhanden ist. 

. VIDEO steht fur NTSC oder PAL. 

• FREQ gibt die Netzfrequenz an (60Hz oder 50Hz). 

Beispiel: 

/*Numerische Zeichenfolge ist: "9 SCIENTIFIC"*/ 

PARSE NUMERIC DIGITS FUZZ FORM . 

SAY digits /*9*/ 

SAY fuzz /*0*/ 

SAY form / *SCIENTIFIC*/ 

myvar = 1234567890 

PARSE VAR myvar la3b+2cld 

SAY a 

SAY b 

SAY c 

SAY d 

Dieses Programm erzeugt folgende Ausgabe: 

12 
34 
567890 

1234567890 
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PROCEDURE PROCEDURE [EXPOSE Variable [Variable...]] 

Der Befehl PROCEDURE wird in einer internen Funktion 
verwendet, um eine neue Symboltabelle zu erstellen. Dies 
verhindert, dafl die Symbole, die in der Aufrufumgebung definiert 
sind, bei der Ausfuhrung der Funktion verandert werden. 
PROCEDURE ist normalerweise die erste Anweisung innerhalb der 
Funktion, sie ware aber auch an jeder anderen Stelle zulassig. 
Werden zwei PROCEDURE-Anweisungen innerhalb einer Funktion 
ausgefuhrt, kommt es zu einem Fehler. 

Das Unterschliisselwort EXPOSE bietet ein selektives Verfahren 
fur den Zugriff auf die Symboltabelle der Aufrufebene und fur die 
Weitergabe globaler Variablen an eine Funktion. Die auf das 
Schliisselwort EXPOSE folgenden Variablen verweisen auf Symbole 
in der Symboltabelle der Aufrufebene. Spatere Anderungen dieser 
Variablen werden in der Umgebung der Aufrufebene beriicksichtigt. 

Die in der Liste EXPOSE aufgefuhrten Variablen konnen 
Stammsymbole oder zusammengesetzte Symbole enthalten. In 
diesem Fall ist die Reihenfolge der Variablen von Bedeutung. Die 
EXPOSE-Liste wird von links nach rechts verarbeitet, 
zusammengesetzte Symbole werden auf der Basis der fur die neue 
Generation geltenden Werte erweitert. Nehmen wir beispielsweise 
an, daB der Wert des Symbols J in der vorherigen Generation 123 
betrug und daB J in der neuen Generation nicht initialisiert ist. 
Dann macht die Anweisung PROCEDURE EXPOSE J A.J die 
Symbole J und A. 123 zuganglich, PROCEDURE EXPOSE A.J J 
dagegen A.J und J. Die Offenlegung eines Stamms bewirkt, daB 
auch alle moglichen, von diesem Stamm abgeleiteten zusammen- 
gesetzten Symbole exponiert werden. Die Anweisung, PROCEDURE 
EXPOSE A. exponiert also A.I, A.J, A. J. J, A. 123 usw. Beispiel: 

fakult: PROCEDURE /*Eine rekursive Funktion*/ 

ARG i 

IF i = 1 

THEN RETURN 1 

ELSE RETURN i * fakult (i-1)" 
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PULL PULL [Schablone] [,Schablone...] 

Pull ist die Kurzform des Befehls PARSE UPPER PULL. Er liest 
eine Zeichenfolge von der Eingabekonsole ein, setzt sie in 
GroBbuchstaben um und analysiert sie mit Hilfe der Schablone. Bei 
Angabe zusatzlicher Schablonen kbnnen mehrere Zeichenfolgen 
gelesen werden. Der Befehl liest auch dann von der Konsole, wenn 
keine Schablone zur Verfugung steht. (Schablonen werden in 
Kapitel 7.1 beschrieben.) Beispiel: 

PULL Vorname Nachname . /*Namen lesen*/ 



PUSH PUSH [Ausdruck] 

Der Befehl PUSH dient dazu, einen Datenstrom so aufzubereiten, 
daiJ er von einer Kommando-Shell oder einem anderen Programm 
gelesen werden kann. Er fiigt ein Zeichen fur Zeilenvorschub an das 
Ergebnis des Ausdrucks an und stellt ihn dann in den Stapel des 
STDIN-Datenstroms. Stapelzeilen werden nach der Regel "last-in, 
first-out" (was zuletzt eingegeben wurde, wird zuerst ausgegeben) in 
den Datenstrom gestellt und konnen gelesen werden, als ob sie 
interaktiv eingegeben worden waren. Nach Ausgabe der Befehle: 

PUSH Zeile 1 
PUSH Zeile 2 
PUSH Zeile 3 

wlirde der Datenstrom in der Reihenfolge Zeile 3, 2, 1 gelesen. 

PUSH ermbglicht, dafi der STDIN-Datenstrom als privates 
"Konzeptpapier" zur Vorbereitung von Daten fur die spatere 
Verarbeitung eingesetzt wird. Es konnten z. B. mehrere Dateien mit 
Einfugung von Begrenzungszeichen verkettet werden, indem 
einfach die Eingabedateien gelesen, mit PUSH in den Datenstrom 
gestellt werden und die Begrenzungszeichen bei Bedarf eingefugt 
werden. Beispiel: 

DO i=l to 5 

PUSH ' echo "Zeile ' i * " ' 
END 
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QUEUE QUEUE [Ausdruck] 

Der Befehl QUEUE dient dazu, einen Datenstrom so aufzubereiten, 
daB er von einer Kommando- Shell oder einem anderen Programm 
gelesen werden kann. Er ist dem Befehl PUSH sehr ahnlich und 
unterscheidet sich von ihm nur insofern, als die Datenzeilen in der 
Reihenfolge "first-in, first-out" (Ausgabe in gleicher Reihenfolge wie 
die Eingabe) in dem STDIN-Datenstrom gestellt werden. In diesem 
Fall wiirden die Befehle: 

QUEUE Zeile 1 
QUEUE Zeile 2 
QUEUE Zeile 3 

in der Reihenfolge Zeile 1, 2, 3 gelesen. Die mit QUEUE gestapelten 
Zeilen gehen stets alien interaktiv eingegebenen Zeilen vor und 
folgen stets nach den mit PUSH gestapelten Zeilen. Beispiel: 

DO i=l to 5 

QUEUE 'echo "Zeile ' i ' " ' 
END 



RETURN RETURN [Ausdruck] 

RETURN dient dazu, eine Funktion zu verlassen und die Steuerung 
an den Punkt zuriickzugeben, von dem aus der vorherige 
Funktionsaufruf erfolgte. Der ausgewertete Ausdruck wird als 
Resultat der Funktion zuruckgegeben. Wird kein Ausdruck 
angegeben, kann es in der Umgebung der Aufrufebene zu einem 
Fehler kommen. Funktionen, die von einem Ausdruck aus 
aufgerufen werden, miissen eine Resultatzeichenfolge zunickgeben. 
Ist kein Ergebnis verfugbar, kommt es zu einem Fehler. 
Funktionen, die vom Befehl CALL aufgerufen werden, brauchen 
kein Ergebnis zuriickzugeben. 

Wird von der Basisumgebung eines Programms ein RETURN 
ausgegeben, ist dies kein Fehler, sondern entspricht dem Befehl 
EXIT (Programm verlassen). Im Abschnitt zum Befehl EXIT wird 
beschrieben, wie Ergebniszeichenfolgen an eine externe Aufruf- 
ebene zuriickgeleitet werden. Beispiel: 

RETURN 6*7 /*Gibt 42 zuruckV 
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SAY SAY [Ausdruck] 

Das Ergebnis des ausgewerteten Ausdrucks wird - mit einem 
angefugten Zeichen fur Zeilenvorschub - in die Ausgabekonsole 
geschrieben. Wird der Ausdruck weggelassen, wird eine leere 
Zeichenfolge an die Konsole gesendet. Beispiel: 

SAY 'Die Antwort ist ' Wert 



SELECT SELECT 

SELECT beginnt einen Befehlsblock, der eine oder mehrere WHEN- 
Klauseln und moglicherweise eine OTHERWISE -Klausel enthalt. 
Auf jede der Klauseln folgt eine bedingte Anweisung. Es wird nur 
eine der bedingten Anweisungen innerhalb der SELECT-Gruppe 
ausgefuhrt. Zunachst werden die einzelnen WHEN-Anweisungen 
nacheinander ausgefuhrt, bis eine zutrifft. Trifft keine zu, wird die 
OTHERWISE-Anweisung ausgefuhrt. Der SELECT-Bereich muB 
durch eine END-Anweisung abgeschlossen werden. Beispiel: 

SELECT 

WHEN i=l THEN SAY ' eins ' 
WHEN i=2 THEN SAY ' zwei * 
OTHERWISE SAY ' andere ' 
END 



SHELL SHELL [Symbol I Zeichenfolge] I [[WERT] [Ausdruck]] 

Der Befehl SHELL ist gleichbedeutend mit dem Befehl ADDRESS. 
Beispiel: 

SHELL edit /*Host auf 'EDIT' setzenV 



SIGNAL SIGNAL {ON I OFF} Bedingung SIGNAL 

[WERT] Ausdruck 

SIGNAL {ON I OFF} steuert den Status der internfen Unter- 
brechungskennzeichen (interrupt flags). Unterbrechungen ermbg- 
lichen es einem Programm, beim Auftreten bestimmter Fehler diese 
zu erkennen und die Steuerung zu behalten. In diesem Fall muB auf 
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SIGNAL eines der Schliisselworter ON oder OFF und eines der im 
folgenden beschriebenen Bedingungsschlusselworter folgen. Das im 
Bedingungssymbol angegebene Unterbrechungskennzeichen wird 
dann auf den angegebenen Status gesetzt. Giiltige Signal- 
bedingungen sind: 

BREAK_C Eine Unterbrechung Ctrl-C wurde erkannt. 

BREAK_D Eine Unterbrechung Ctrl-D wurde erkannt. 

BREAK_E Eine Unterbrechung Ctrl-E wurde erkannt. 

BREAK_F Eine Unterbrechung Ctrl-F wurde erkannt. 

ERROR Ein Host-Kommando gab einen Wert ungleich Null zuruck. 

HALT Eine externe HALT-Anforderung wurde erkannt. 

IOERR Das E/A-System hat einen Fehler festgestellt. 

NOVALUE Eine nicht initialisierte Variable wurde verwendet. 

SYNTAX Ein Syntax- oder Ausfuhrungsfehler wurde festgestellt. 

Die Bedingungsschliisselworter werden als Sprungmarken inter- 
pretiert, an die die Steuerung ubertragen wird, wenn die 
ausgewahlte Bedingung eintritt. 1st z. B. die ERROR-Unter- 
brechung aktiviert und ein Kommando gibt einen Wert ungleich 
Null zuruck, iibertragt ARexx die Steuerung an die Sprungmarke 
ERROR:. Diese Bedingungssprungmarke mufl natiirlich im Pro- 
gramm definiert sein. Andernfalls kommt es sofort zu einem 
SYNTAX-Fehler, und das Programm wird verlassen. 

In SIGNAL [WERT] Ausdruck werden die auf SIGNAL folgenden 
Token als Ausdruck ausgewertet. Es wird eine sofortige Unter- 
brechung generiert, die die Steuerung an die im Ausdrucksergebnis 
definierte Sprungmarke iibergibt. Der Befehl hat also den Effekt 
eines "berechneten GOTO". 

Sobald eine Unterbrechung eintritt, werden alle derzeit aktiven 
Steuerbereiche (IF, DO, SELECT, INTERPRET oder interaktiver 
TRACE) vor der Steuerungsiibergabe inaktiviert. Die Ubergabe 
kann also nicht dazu verwendet werden, in den Bereich einer DO- 
Schleife oder einer anderen Steuerungsstruktur zu springen. Da 
sich eine SIGNAL-Bedingung nur auf die Steuerungsstrukturen der 
aktuellen Umgebung auswirkt, ist es gefahrlos moglich, innerhalb 
einer internen Funktion ein SIGNAL auszulosen. Der Status der 
Aufrufumgebung wird dadurch nicht beriihrt. 
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Die Sondervariable SIGL wird, sobald es zu einer Steuerungs- 
iibertragung kommt, auf die aktuelle Zeilennummer gesetzt. Das 
Programm kann anhand einer Uberpriifung von SIGL feststellen, 
welche Zeile vor der Ubertragung der Steuerung ausgefuhrt wurde. 
Verursacht eine ERROR- oder SYNTAX-Bedingung eine Unter- 
brechung, wird die Sondervariable RC auf den Fehlercode gesetzt, 
der die Unterbrechung ausloste. Im Fall der ERROR-Bedingung 
gibt dieser Code normalerweise den Schweregrad des Fehlers an. 
Einzelheiten zu Fehlercodes und Schweregraden finden Sie in 
Anhang A. Die SYNTAX-Bedingung lafit stets auf einen ARexx- 
Fehlercode schlieflen. Beispiel: 

SIGNAL on error /^Unterbrechung aktivieren*/ 

SIGNAL off syntax /^SYNTAX inaktivieren* / 
SIGNAL start /*Zu START springen*/ 



WHEN WHEN Ausdruck [THEN [;] [bedingte Anweisung]] 

Der Befehl WHEN ist dem Befehl IF vergleichbar, ist allerdings nur 
innerhalb eines SELECT-Bereichs giiltig. Alle WHEN-Ausdrucke 
werden nacheinander ausgewertet und miissen einen booleschen 
Wert ergeben. Ist das Ergebnis 1, wird die bedingte Anweisung 
ausgefuhrt, und die Steuerung geht an die END-Anweisung uber, 
die SELECT beendet. THEN braucht (genau wie beim Befehl IF) 
nicht Bestandteil derselben Klausel zu sein. Beispiel: 

SELECT 

WHEN i<j THEN SAY ' kleiner ' 
WHEN i=j THEN SAY 'gleich' 
OTHERWISE SAY ' grower ' 
END 



Kapitel 5 

Funktionen 



Unter einer Funktion versteht man ein Programm oder eine Gruppe 
von Anweisungen, das/die ausgefuhrt wird, wenn der Funktions- 
name innerhalb eines bestimmten Kontexts aufgerufen wird. Eine 
Funktion kann Teil eines internen Programms, einer Bibliothek 
oder eines separaten externen Programms sein. Funktionen sind 
wichtige Bauteile bei der modularen Programmierung, da sie den 
Aufbau komplexer Programme aus mehreren kleinen, einfacher zu 
entwickelnden Modulen ermoglichen. 

In diesem Kapitel werden die verschiedenen Funktionsarten vorge- 
stellt und ihre Auswertung beschrieben. Das Kapitel enthalt eine 
alphabetisch geordnete Liste der in der integrierten ARexx- 
Funktionsbibliothek enthaltenen Funktionen. 



5.1 A ufrufen einer Funktion 

Innerhalb eines ARexx-Programms ist eine Funktion definiert als 
ein Symbol oder eine Zeichenfolge, auf das/die unmittelbar eine 
bffnende runde Klammer folgt. Das Symbol oder die Zeichenkette 
(interpretiert als Literal) gibt den Funktionsnamen an. Nach der 
offenen Klammer beginnt die Liste der Argumente. Zwischen den 
Klammern stehen null oder mehr Argumentausdriicke, getrennt 
durch Kommas, die die Daten liefern, die an die Funktion iiber- 
geben werden. 

Giiltige Funktionsaufrufe sind: 

CENTER ( ' titel' ,20) 
ADDRESS ( ) 
'ALLOCMEM' (256*4,1) 
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Alle Argumentausdrucke werden nacheinander ausgewertet, die 
daraus resultierenden Zeichenfolgen werden als Argumentenliste 
an die Funktion weitergegeben. Jeder Argumentausdruck (haufig 
nur ein einzelner Literalwert) kann arithmetische oder Zeichen- 
folgenoperationen oder auch andere Funktionsaufrufe enthalten. 
Argumentausdrucke werden in der Reihenfolge von links nach 
rechts ausgewertet. Funktionen konnen auch mit dem Befehl CALL 
aufgerufen werden. Der Befehl CALL (siehe Kapitel 4.2) kann zum 
Aufrufen einer Funktion eingesetzt werden, die moglicherweise 
keinen Wert zuruckgibt. 



5.2 Funktionsarten 

Man unterscheidet drei Arten von Funktionen: 

• Interne Funktionen — definiert innerhalb des ARexx-Pro- 
gramms. 

• Integrierte Funktionen — stammen aus der ARexx-Program- 
miersprache. 

• Funktionsbibliotheken — eine spezielle Amiga-Bibliothek fur 
gemeinsame Benutzung. 

5.2. 1 Interne Funktion 

Eine interne Funktion wird durch eine Sprungmarke innerhalb des 
Programms gekennzeichnet. Bei Aufruf der internen Funktion 
erstellt ARexx eine neue Speicherumgebung, damit die Umgebung 
der vorherigen Aufrufebene unverandert bleibt. Die neue Umge- 
bung ubernimmt die Werte ihres Vorgangers, spatere Veran- 
derungen dieser Umgebung haben aber keine Auswirkung auf die 
vorherige Umgebung. 

Folgende Werte werden geschutzt bzw. beibehalten: 

• Die aktuelle und die vorherige Host-Adresse 

. Die Vorgaben fur NUMERIC DIGITS, FUZZ und FORM 

• Die Ablaufverfolgungsoption, das Sperrungskennzeichen und 
das interaktive Kennzeichen 
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• Der Status der durch den Befehl SIGNAL defmierten 
Unterbrechungskennzeichen 

• Die aktuelle Zeichenfolge der Eingabeaufforderung gemaB Vor- 
gabe im Befehl OPTIONS PROMPT 

Die neue Umgebung erhalt nicht automatisch eine neue 
Symboltabelle, so daB der aufgerufenen Funktion zunachst einmal 
alle Variablen aus der vorherigen Umgebung zur Verfugung stehen. 
Der Befehl PROCEDURE kann zum Erstellen einer eigenen Tabelle 
genutzt werden, wodurch die Symbolwerte der Aufrufebene 
geschlitzt werden. PROCEDURE kann auch verwendet werden, um 
ein und denselben Variablennamen in zwei verschiedenen 
Bereichen mit zwei unterschiedlichen Werten verwenden zu 
konnen. 

Die Ausfuhrung der internen Funktion wird fortgesetzt, bis ein 
RETURN-Befehl ausgefuhrt wird. An dieser Stelle wird die neue 
Umgebung wieder inaktiviert, und die Steuerung kehrt zu dem 
Punkt zuriick, an dem der Funktionsaufruf erfolgte. Der mit dem 
Befehl RETURN angegebene Ausdruck wird ausgewertet und als 
Funktionsergebnis an die Aufrufebene zuriickgeleitet. 

5.2.2 Integrierte Funktionen 

Als Bestandteil des Sprachsystems bietet ARexx eine umfangreiche 
Bibliothek vordefmierter Funktionen. Diese Funktionen sind stets 
verfugbar und auf die Zusammenarbeit mit den internen Daten- 
strukturen optimal zugeschnitten. Im allgemeinen laufen die 
integrierten Funktionen wesentlich schneller ab als entsprechende 
interpretierte Funktionen. Aus diesem Grund wird ihre Verwen- 
dung dringend empfohlen. 

Manche integrierte Funktionen erstellen und verwalten externe 
AmigaDOS-Dateien. Auf Dateien wird iiber einen logischen Namen 
Bezug genommen. Bei diesem Namen, der einer Datei beim 
erstmaligen Offhen zugeordnet wird, wird zwischen GroB- und 
Kleinschreibung unterschieden. Die ursprunglichen Ein- und 
Ausgabedatenstrome erhalten die Namen STDIN (Standardeingabe) 
und STDOUT (Standardausgabe). Theoretisch konnen beliebig viele 
Dateien gleichzeitig gebffnet sein, allerdings ist der verfugbare 
Arbeitsspeicher naturlich nicht unendlich groB, so daB Sie 
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irgendwann an dessen Grenzen stoBen, wenn Sie "unendlich viele" 
Dateien zu offnen versuchen. Beim Verlassen des Programms 
werden alle geoffheten Dateien automatisch geschlossen. 

5.2.3 Externe Funktionsbibliotheken 

Eine Funktionsbibliothek (engl. shared Library) ist eine Sammlung 
einer oder mehrerer Funktionen, die als gemeinsam benutzbare 
Amiga-Bibliothek aufgebaut ist. Die Bibliothek muB in LIBS: 
gespeichert sein, gleich ob festplatten- oder speicherresident. 
Festplattenresidente Bibliotheken werden bei Bedarf geladen und 
gebffhet. 

Die Bibliothek muB speziell fur die Verwendung durch ARexx 
zugeschnitten sein. Jede Funktionsbibliothek muB einen Biblio- 
theksnamen, eine Suchprioritat, eine relative Einstiegsposition und 
eine Versionsnummer besitzen. Wenn ARexx nach einer Funktion 
sucht, offnet der Interpreter jede einzelne Bibliothek und prlift den 
"query"-Einstiegspunkt. Dieser Einstiegspunkt muB als ganzzahlige 
Position (z. B. "-30") relativ zur Bibliotheksbasis vorliegen. Der 
Riickgabewert des Abfrageaufrufs gibt an, ob die gewiinschte 
Funktion gefunden wurde. Wenn ja, wird sie mit den vom Inter- 
preter libergebenen Parametern aufgerufen, und das Funktions- 
ergebnis wird an die Aufrufebene zuriickgegeben. Wird sie nicht 
gefunden, wird ein Fehlercode fur "Funktion nicht gefunden" 
zunickgemeldet, und die Suche wird in der nachsten Bibliothek auf 
der Liste fortgesetzt. Funktionsbibliotheken werden nach der 
Uberprufung stets geschlossen, so daB das Betriebssystem bei 
Bedarf wieder liber den Hauptspeicherplatz verfugen kann. 

5.2.3. 1 Bibliotheksliste 

Der residente ARexx-ProzeB verwaltet eine Liste der zur Zeit 
verfiigbaren Funktionsbibliotheken und Funktions-Hosts (s. u.): die 
sog. Bibliotheksliste. Anwendungsprogramme konnen bei Bedarf 
Funktionsbibliotheken hinzufiigen oder entfernen. 

Die Bibliotheksliste wird als eine nach Prioritatswerten sortierte 
Listenstruktur verwaltet. Jeder Eintrag besitzt einen ihm zuge- 
ordneten Suchprioritatswert von 100 (hochste Prioritat) bis -100 
(niedrigste Prioritat). Eintrage konnen mit einer geeigneten 
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Prioritat hinzugefugt werden, um die Auflosung des Funktions- 
namens zu steuern. Bibliotheken mit hoheren Prioritatswerten 
werden zuerst durchsucht. Innerhalb einer vorgegebenen Prioritats- 
ebene werden die zuerst hinzugefugten Bibliotheken auch zuerst 
durchsucht. Die Prioritatsebenen sind von Bedeutung, wenn z. B. 
mehrere Bibliotheken identische Definitionen von Funktionsnamen 
aufweisen, da die in der Suchfolge weiter unten stehenden 
Funktionen sonst niemals aufgerufen werden konnen. 

5.2.4 Externe Funktions-Hosts 

Der einem Funktions-Host zugewiesene Name ist der Name seines 
offentlich zuganglichen Message-Ports. Funktionsaufrufe werden in 
Form eines Nachrichtenpakets an den Host weitergegeben. Danach 
stellt der jeweilige Host fest, ob er den angegebenen Funktions- 
namen erkennt. Die Namensauflosung ist ein interner Host- 
Vorgang. Funktions-Hosts bieten ein naturliches Gateway- Ver- 
fahren zur Implementierung ferner Prozeduraufrufe an andere 
Maschinen innerhalb eines Netzes. Der residente ARexx-ProzeB ist 
ein Funktions-Host und wird in der Bibliotheksliste mit einer 
Prioritat von -60 installiert. 



5.3 Suchreihenfolge 



Funktionseinbindungen in ARexx werden zum Zeitpunkt des 
Funktionsaufrufs hergestellt. Eine bestimmte Suchreihenfolge wird 
eingehalten, bis eine Funktion gefunden wird, die mit dem Namens- 
symbol oder der Zeichenfolge ubereinstimmt. Ist die angegebene 
Funktion nicht auffindbar, hat dies einen Fehler zur Folge, und die 
Auswertung des Ausdrucks wird beendet. Die vollstandige Such- 
reihenfolge sieht wie folgt aus: 
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Funktionen 



Interne Funktionen 



Integrierte Funktionen 



Funktionsbibliotheken 
und Funktions-Hosts 



Der Quelltext des Programms wird auf eine 
Sprungmarke hin untersucht, die dem Funktions- 
namen entspricht. Wird eine Entsprechung ge- 
funden, so wird eine neue Speicherumgebung 
erstellt, und die Steuerung geht auf diese 
Sprungmarke uber. 

Die Bibliothek mit den integrierten Funktionen 
wird nach dem angegebenen Namen durch- 
sucht. Alle diese Funktionen werden durch 
Namen in GroBbuchstaben definiert. 

Die verfugbaren Funktionsbibliotheken und 
Funktions-Hosts werden in der Bibliotheksliste 
verwaltet, die in der Reihenfolge der Prioritats- 
werte durchsucht wird, bis die Funktion gefun- 
den Oder das Ende der Liste erreicht ist. 
Funktions-Hosts werden uber ein Nachrichten- 
ubertragungsprotrokoll aufgerufen, das dem fur 
Kommandos verwendeten Protokoll vergleichbar 
ist. Sie konnen als Gateways fur feme Prozedur- 
aufrufe an andere Maschinen innerhalb eines 
Netzes verwendet werden. 

Der letzte Schritt in der Reihenfolge ist die Suche 
nach einer externen ARexx-Programm-datei. Zu 
diesem Zweck wird eine Nachricht an den 
residenten ARexx-ProzeB gesendet. Die Suche 
beginnt stets im aktuellen Verzeichnis und folgt 
dann dem gleichen Suchpfad wie der 
ursprungliche Aufruf des ARexx-Programms. 
Beim Namensabgleich spielt GroB- und Klein- 
schreibung keine Rolle. 

Bitte beachten Sie, dafi die Prozedur des Funktionsnamenabgleichs 
bei einigen Suchschritten zwischen GroB- und Kleinschreibung 
unterscheidet, bei anderen nicht. Ob dies bei der Abgleichsprozedur 
in einer Funktionsbibliothek oder einem Funktions-Host der Fall 
ist, liegt im Ermessen des Programmierers. Funktionen, in deren 
Namen GroB- und Kleinbuchstaben vorkommen, mlissen liber ein 
Zeichenfolge-Token aufgerufen werden, da Symbolnamen stets in 
GroBbuchstaben umgewandelt werden. 



Externe ARexx- 
Programme 
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Die vollstandige Suchreihenfolge wird immer dann eingehalten, 
wenn der Funktionsname durch ein Symbol-Token definiert ist. Die 
Suche nach internen Funktionen wird dagegen umgangen, wenn 
der Name in einem Zeichenfolge-Token steht. Dies gibt internen 
Funktionen die Moglichkeit, die Namen externer Funktionen zu 
besetzen, wie das folgende Beispiel zeigt: 

CENTER : / * int erne s " CENTER " * / 

ARG Zeichenf olge, Lang /^Argumente holen*/ 

Lang = MIN{Lang,60) /*Langenwert ggf. andern*/ 
return 'CENTER' ( Zeichenf olge , Lang) 

Hier wurde die integrierte Funktion CENTERO nach Anderung des 
Langenarguments durch eine interne Funktion ersetzt. 
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Die Clip-Liste ist eine allgemein zugangliche Einrichtung, die als 
Zwischenspeicher (engl. "clipboard") fur die Kommunikation 
zwischen verschiedenen Programmen dienen kann. Viele Funk- 
tionen benutzen diesen Zwischenspeicher zum Abrufen verschie- 
dener Arten von Daten, z. B. vordefinierte Konstanten oder 
Zeichenfolgen. 

Die Clip-Liste verwaltet eine Reihe von Begriffspaaren (Name, 
Wert), die vielseitig verwendbar sind. (Mit SETCLIPO konnen Sie 
neue Begriffspaare in die Liste einfugen.) Jeder Listeneintrag 
besteht aus einer Namens- und einer Wertzeichenfolge und kann 
anhand des Namens lokalisiert werden. Im allgemeinen sollten die 
Namen so gewahlt werden, daB sie innerhalb einer Anwendung nur 
einmal vorkommen, um unbeabsichtigte Namenskonflikte mit 
anderen Programmen zu vermeiden. Die Anzahl der Listeneintrage 
ist beliebig. 

Eine mogliche Anwendung der Clip-Liste ware ein Mechanismus 
zum Laden vordefinierter Konstanten in ein ARexx-Programm. 
Beispiel: 

pi=3. 14159; e-2.718; sqrt2=1.414 . . . 

(also eine Reihe von Wertzuweisungen, jeweils getrennt durch 
Semikolons). Eine solche Zeichenfolge kann anhand ihres Namens 
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iiber die integrierte Funktion GETCLIPO abgerufen und danach 
innerhalb des Programms INTERPRETiert werden. Die Zuord- 
nungsanweisungen innerhalb der Zeichenfolge wlirden dann die 
benotigten Konstantendefinitionen bewirken. Beispiel: 

/*angenommen, die Zeichenfolge "konstanten" ist 

verfiigbar*/ 

konstanten = GETCLIP (' konstanten ' ) 

INTERPRET konstanten /*. . . ZuordnungenV 

Die Zeichenfolge ware nicht ausschlieBlich auf Zuweisungs- 
anweisungen beschrankt, sondern konnte auch beliebige giiltige 
ARexx-Anweisungen enthalten. Die Clip-Liste konnte also eine 
Reihe von Programmen mit Initialisierungen und anderen Verarbei- 
tungsaufgaben versorgen. 

Der residente ProzeB unterstlitzt Hinzufuge- und Loschoperationen 
zur Verwaltung der Clip-Liste. Beztiglich der Namen in den 
Begriffspaaren (Name,Wert) wird angenommen, daB sie GroB- und 
Kleinschreibung enthalten und innerhalb der Liste nicht mehrmals 
vorkommen. Der Versuch, eine Zeichenfolge mit einem bereits 
vorhandenen Namen hinzuzufugen, fuhrt lediglich zur Aktua- 
lisierung der Wertzeichenfolge. Wenn ein neuer Eintrag in die Liste 
gestellt wird, werden die Namens- und Wertzeichenfolgen kopiert, 
so daB das Programm, das einen Eintrag hinzufugt, diese 
Zeichenfolgen nicht weiter verwalten muB. 

In die Clip-Liste gestellte Eintrage bleiben verfiigbar, bis sie explizit 
aus der Liste geloscht werden. Bei Verlassen des residenten 
Prozesses wird die Clip-Liste automatisch verlassen. 



5.5 Liste der integrierten 
Funktionen 

Dieser Abschnitt enthalt eine alphabetisch geordnete Liste der 
integrierten Funktionen. Die Syntax der einzelnen Funktionen 
steht jeweils rechts vom Funktionsschliisselwort. 
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5.5. 1 Syntax 

Wahlfreie Argumente stehen in eckigen Klammern und haben 
normalerweise einen Standardwert, der verwendet wird, wenn das 
Argument nicht explizit angegeben wird. Wird ein Options- 
schliisselwort als Argument angegeben, ist nur das erste Zeichen 
von Bedeutung. Bei Optionsschliisselwortern wird nicht zwischen 
GroB- und Kleinschreibung unterschieden. 

Viele Funktionen erlauben Fullzeichenargumente. Flillzeichen 
werden eingefugt, um Leerzeichen aufzufullen bzw. zu erstellen. 
Bei so einem Fullzeichenargument ist nur das erste Zeichen der 
Argumentzeichenfolge von Bedeutung. Bei Angabe einer leeren 
Zeichenfolge wird das standardmaBige Fiillzeichen (in der Regel das 
Leerzeichen) verwendet. 

In den folgenden Beispielen bedeutet ein Pfeil (— ») "wird 
ausgewertet als", "ergibt". Der Pfeil wird nicht angezeigt, wenn ein 
Programm ausgefuhrt wird. Beispiel: 

SAY ABS(-5.35) -^5.3 5 

Dies bedeutet, daB SAY ABS(-5.35) bei Auswertung 5.35 ergibt. 



5.5.2 Alphabetische Liste 

ABBREVO ABBREV(Zeichenfolgel,Zeichenfolge2[,Lange]) 

Diese Funktion gibt einen booleschen Wert zuriick, der angibt, ob 
Zeichenfolge2 eine Abkurzung von Zeichenfolge 1 mit einer Lange 
grofier oder gleich der Angabe im Argument "Lange" ist. Standard- 
lange ist 0, eine leere Zeichenfolge ist also ebenfalls als Abkurzung 
zulassig. Beispiel: 

SAY ABBREV( 'vollname 1 , 'voll 1 ) -> 1 
SAY ABBREV( 'nahezu, ' nah ' ,4) -^ 

SAY ABBREV( 'beliebig' , ' ' ) ->1 
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ABSO ABS(Zahl) 

Gibt den absoluten Wert des Arguments "Zahl" zuriick. Dies muB 
ein numerischer Wert sein. Beispiel: 

SAY ABS(-5.35) -> 5.3 5 

SAY ABS(IO) -» 10 



ADDLIBO ADDLIB(Name,Prioritat[,OfFset,Version]) 

Fiigt eine Funktionsbibliothek oder einen Funktions-Host in die 
vom residenten ProzeB verwaltete Bibliotheksliste ein. Das 
Argument "Name" bezeichnet entweder den Namen einer Funk- 
tionsbibliothek oder den einem Funktions-Host zugeordneten, 
allgemein zuganglichen Message-Port. Bei diesem Namen wird 
zwischen Grofl- und Kleinschreibung unterschieden. Alle angegeben 
Bibliotheken sollten im Systemverzeichnis LIBS: stehen. 

Das Argument "Prioritat" bestimmt die Suchprioritat und muB als 
ganze Zahl im Bereich von 100 bis -100, angegeben werden. Die 
Argumente "Offset" und "Version" gelten nur fur Bibliotheken. Der 
Offset ist der ganzzahlige Abstand zum "Query"-Einstiegspunkt der 
Bibliothek. Version ist ebenfalls eine ganze Zahl, die die mindestens 
erforderliche Version der Bibliothek angibt. 

Die Funktion gibt einen booleschen Wert zuriick, aus dem hervor- 
geht, ob die Operation erfolgreich verlief. Beachten Sie bitte, daB 
eine angegebene Bibliothek zu diesem Zeitpunkt noch nicht geoffhet 
wird. Entsprechend iiberpruft ARexx auch noch nicht, ob der Port 
eines angegebenen Funktions-Hosts geoffhet ist. Beispiel: 

SAY ADDLIB("rexxsupport. library ",0,-3 0,0) -> 1 
CALL ADDLIB "EtherNet " , -2 /*Ein Gateway*/ 



Funktionen 5-11 



ADDRESSO ADDRESSO 

Gibt die aktuelle Zeichenfolge der Host-Adresse zurtick. Die Host- 
Adresse ist der Message-Port, an den Kommandos gesendet werden. 
Mit der Funktion SHOWO kann gepriift werden, ob der gewiinschte 
externe Host auch tatsachlich verfugbar ist (siehe auch SHOWO). 
Beispiel: 

SAY ADDRESS { ) -» REXX 



ARG() AKG([Nummer][,'EXISTS' I 'OMITTED']) 

ARGO gibt die Anzahl der Argumente zuriick, die der aktuellen 
Umgebung zur Verfugung gestellt wurden. Wird nur das Argument 
"Nummer" angegeben, wird die entsprechende Argumentzeichen- 
folge zuriickgegeben. Bei Angabe einer Nummer und des Schlussel- 
worts EXISTS (vorhanden) oder OMITTED (nicht vor-handen) zeigt 
der boolesche Ruckgabewert den Status des entsprechenden 
Arguments an. Beachten Sie bitte, dafl die Uberpriifung mit dem 
Schlusselwort EXISTS oder OMITTED nicht darauf schliefien lafit, 
ob die betreffende Zeichenfolge einen Nullwert hat, sondern nur, ob 
iiberhaupt eine Zeichenfolge angegeben wurde. Beispiel: 

/*Angenommen, die Argumente sind: ( ' eins * , , 10 ) */ 
SAY ARG () -» 3 

SAY ARG(l) -» eins 

SAY ARG ( 2 , ' * ) -» 1 



B2C() B2C(Zeichenfolge) 

Wandelt eine Zeichenfolge aus Binarziffern (0,1) in die ent- 
sprechende (gepackte) Zeichendarstellung um. Die Umwandlung 
lauft genau so ab wie bei Angabe des Arguments "Zeichenfolge" als 
Binarzeichenliteral (z. B. '1010'B). Leerzeichen in der Zeichenfolge 
sind zulassig, allerdings nur an Bytegrenzen. Diese Funktion eignet 
sich besonders fur die Erstellung von Zeichenfolgen, die als Bit- 
masken verwendet werden sollen (siehe auch X2C0). Beispiel: 

SAY B2C( '00110011' ) -» 3 

SAY B2C( ' 01100001' ) -» a 
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BITANDO BITAND(Zeichenfolgel,Zeichenfolge2[,Fullzeichen]) 

Die Argumente "Zeichenfolgel" und "Zeichenfolge2" werden durch 
ein logisches UND miteinander verbunden, wobei das Ergebnis so 
lang ist wie die langere der beiden Operandenzeichenfolgen. Wird 
ein Fiillzeichen angegeben, so wird die kiirzere Zeichenfolge rechts 
damit aufgefullt. Andernfalls wird die Operation am Ende der 
kiirzeren Zeichenfolge beendet. Der Rest der langeren Zeichenfolge 
wird an das Ergebnis angehangt. Beispiel: 

BITAND( '0313 'x, ' FFFO 'x) -^ '0310'x 



BITCHGO BITCHG(Zeichenfolge,Bit) 

Andert den Status des angegebenen Bits im Argument 
"Zeichenfolge". Die Bits sind so numeriert, daB Bit das nieder- 
wertigste Bit des am weitesten rechts liegenden Bytes der Zeichen- 
folge ist. Beispiel: 

BITCHG{ l 0313'x / 4) -^ '0303'x 



BITCLRO BITCLR(Zeichenfolge,Bit) 

Mit dieser Funktion wird das angegebene Bit im Argument 
"Zeichenfolge" geloscht (d. h. auf Null gesetzt). Die Bits sind so 
numeriert, daB Bit das niederwertigste Bit des am weitesten 
rechts liegenden Bytes der Zeichenfolge ist. Beispiel: 

BITCLR( '0313 ' x,4) -> '03 03'x 
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BITCOMPO BITCOMP(Zeichenfolgel,Zeichenfolge2L,Fullzeichen]) 

Vergleicht die Argumente "Zeichenfolge 1" und "Zeichenfolge2" 
bitweise, beginnend bei Bitnunimer 0. Der zuriickgegebene Wert ist 
die Bitnummer des ersten Bits, bei dem sich die Zeichenfolgen 
unterscheiden, oder -1, falls die Zeichenfolgen identisch sind. 
Beispiel: 

BITCOMP ( ' 7F 'x, 'FF 'x) -» 7 /*Bit Nr . 7*/ 

BITCOMP ( ' FF 'x, ' FF 'x) -> -1 



BITORO BITOR(Zeichenfolgel,Zeichenfolge2[,Fullzeichen]) 

Die Argumente "Zeichenfolgel 1 ' und "Zeichenfolge2" werden durch 
ein logisches ODER miteinander verkniipft, wobei das Ergebnis so 
lang ist wie die langere der beiden Operandenzeichenfolgen. Wird 
ein Fiillzeichen angegeben, so wird die kiirzere Zeichenfolge rechts 
damit aufgefullt. Andernfalls wird die Operation am Ende der 
klirzeren Zeichenfolge beendet. Der Rest der langeren Zeichenfolge 
wird an das Ergebnis angehangt. Beispiel: 

BITOR( , 0313'x / , 003F , x) -^ '033F'x 



BITSETO BITSET(Zeichenfolge,Bit) 

Setzt das angegebene Bit im Argument "Zeichenfolge" auf 1. Die 
Bits sind so numeriert, daB Bit das niederwertigste Bit des am 
weitesten rechts liegenden Bytes der Zeichenfolge ist. Beispiel: 

BITSET( '0313 F x,2) -> '0317'x 



BITTSTO BITTST(Zeichenfolge,Bit) 

Der boolesche Rlickgabewert bezeichnet den Status des ange- 
gebenen Bits im Argument "Zeichenfolge". Die Bits sind so 
numeriert, daB Bit das niederwertigste Bit des am weitesten 
rechts liegenden Bytes der Zeichenfolge ist. Beispiel: 

BITTST( ' 0313 'x,4) -> 1 
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BITXORO BITXOR(Zeichenfolgel,Zeichenfolge2[,Fullzeichen]) 

Die Argumente "Zeichenfolgel" und "Zeichenfolge2" werden durch 
ein logisches Exklusiv-ODER miteinander verkntipft, wobei das 
Ergebnis so lang ist wie die langere der beiden Operanden- 
zeichenfolgen. Wird ein Fiillzeichen angegeben, so wird die klirzere 
Zeichenfolge rechts damit aufgefullt Andernfalls wird die Operation 
am Ende der kiirzeren Zeichenfolge beendet, und der Rest der 
langeren Zeichenfolge wird an das Ergebnis angehangt. Beispiel: 

BITXOR( '0313'x, 'OOlF'x) -» '03 OCX 



C2B() C2B(Zeichenfolge) 

Wandelt die Zeichenfolge aus Textzeichen in die entsprechende 
Zeichenfolge aus Binarziffern um (siehe auch C2X()). Beispiel: 

SAY C2B('abC.) -» 011000010110001001100011 



C2D() C2D(Zeichenfolge[,n]) 

Wandelt das Argument "Zeichenfolge" von normalen Textzeichen in 
die entsprechende Dezimalzahl um (ausgedrlickt in ASCII-Ziffern, 
als 0-9). Wird n angegeben, so wird die Textzeichenfolge als in n 
Byte angegebene Zahl betrachtet. Die Zeichenfolge wird abge- 
schnitten oder links mit Nullen aufgefullt. Das Vorzeichenbit wird 
fur die Umwandlung erweitert. Beispiel: 

SAY C2D( ' 0020 'x) -» 32 

SAY C2D('FFFF ffff'x) -^ -1 

SAY C2D( 'FF0100 p x,2) -> 256 



C2X() C2X(Zeichenfolge) 

Wandelt das Argument "Zeichenfolge" von normalen Textzeichen in 
die entsprechende Hexadezimalzahl um (ausgedriickt in den ASCII- 
Zeichen 0-9 und A-F (siehe auch C2B()). Beispiel: 

SAY C2X( "abC ) -> 616263 
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CENTERO CENTER(Zeichenfolge,Lange[ 7 Fiillzeichen]) 

CENTREO CENTRE(Zeichenfolge,Lange[,Fullzeichen]) 

Zentriert das Argument "Zeichenfolge" innerhalb einer Zeichenfolge 
der angegebenen Lange. 1st der Wert "Lange" groBer als die Lange 
der Zeichenfolge, werden Full- oder Leerzeichen nach Bedarf einge- 
fugt. Beispiel: 

SAY CENTER { ' abc ' , 6 ) -> ' abc 

SAY CENTER ( ' abc ' , 6 , * + ' ) -» ' +abc + + ' 
SAY CENTER( '123456' ,3) -» '234' 



CLOSEO CLOSE(Datei) 

SchlieBt die Datei, deren logischer Name angegeben wurde. War die 
Datei gebffnet, zeigt der boolesche Wert 1 die erfolgreiche Durch- 
fiihrung der Operation an. Beispiel: 

SAY CLOSE ( ' input ' ) -> 1 



COMPAREO COMPARE(Zeichenfolgel,Zeichenfolge2[,Fullz.]) 

Vergleicht zwei Zeichenfolgen und gibt den Indexwert der ersten 
Position zuriick, an der sich die Zeichenfolgen unterscheiden (oder 
0, wenn die Zeichenfolgen identisch sind). Die kiirzere Zeichenfolge 
wird bei Bedarf rechts mit dem angegebenen Fullzeichen oder mit 
Leerzeichen aufgefullt. Beispiel: 

SAY COMPARE ( ' abcde ' , ' abcce ' ) -^4 

SAY COMPARE ( ' abcde ' , * abcde ' ) -> 
SAY COMPARE ( ' abc++ ' , ' abc+- ','+') -> 5 
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COMPRESSO COMPRESS(Zeichenfolge[,Liste]) 

Wird das Argument "Liste" weggelassen, entfernt die Funktion 
voran- oder nachgestellte sowie eingebettete Leerzeichen aus dem 
Argument "Zeichenfolge". Wird das wahlfreie Argument "Liste" 
(auch eine Zeichenfolge) dagegen angegeben, legt es die aus der 
Zeichenfolge zu entfernenden Zeichen fest. Beispiel: 

SAY COMPRESS (' wie viel ') -> wieviel 

SAY COMPRESS ( '++12-34-+ ','+-' ) -» 1234 



COPIESO COPIES(Zeichenfolge,Zahl) 

Erstellt eine neue Zeichenfolge, indem die angegebene Anzahl 
Kopien der Originalzeichenfolge aneinandergefugt wird. Als Zahl 
kann auch Null angegeben werden. In diesem Fall wird eine leere 
Zeichenfolge zurlickgegeben. Beispiel: 

SAY COPIES ( 'abc' ,3) -> abcabcabc 



D2C() D2C(Zahl) 

Erstellt eine Zeichenfolge, deren Wert die binare (gepackte) 
Darstellung der angegebenen Dezimalzahl ist. Beispiel: 

D2C(65) -» A 



D2X() D2X(Zahl[,Ziffern]) 

Wandelt eine Dezimalzahl in eine Hexadezimalzahl um. Beispiel: 

D2X(31) -^ IF 

DATEO DATE([Option][,Datum][,Format]) 

Gibt das aktuelle Datum im angegebenen Format zuriick. Die 
Standardoption (NORMAL) gibt das Datum im Format TT MMM 
JJJJ zunick, z. B. 20 APR 1992. Folgende Optionen werden 
erkannt: 
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BASEDATE Die Anzahl der Tage seit dem 1 . Januar 0001 

CENTURY Die Anzahi der Tage seit dem 1 . Januar dieses 

Jahrhunderts 

DAYS Die Anzahl der Tage seit dem 1 . Januar des aktuellen 

Jahres 

EUROPEAN Das Datum im Format TT/MM/JJ 

INTERNAL Interne Systemtage 

JULIAN Das Datum im Format JJTTT 

MONTH Der aktuelle Monat (in GroB- und Kleinschreibung) 

NORMAL Das Datum im Format TT MMM JJJJ 

ORDERED Das Datum im Format JJ/MM/TT 

SORTED Das Datum im Format JJJJMMTT 

USA Das Datum im Format MM/TT/JJ 

WEEKDAY Der Wochentag (in GroB- und Kleinschreibung) 

Diese Optionen konnen abgektirzt werden. Es geniigt die Angabe 
des jeweils ersten Zeichens. 

Die Funktion DATE() akzeptiert auch wahlfreie zweite und dritte 
Argumente, mit denen das Datum in Form der internen Systemtage 
oder in der sortierten Form JJJJMMTT angegeben werden kann. 
Das zweite Argument gibt entweder Systemtage (Standardwert) 
oder ein sortiertes Datumsformat an. Das dritte Argument 
bestimmt, welches dieser Formate verwendet wird und kann 
entweder T oder 'S' lauten. Das aktuelle Datum in Systemtagen 
kann mit der Angabe DATE(TNTERNAL') abgerufen werden. 
Beispiel: 



SAY DATEO 
SAY DATE ('M') 
SAY DATE(S) 
SAY DATE ( ' S 



-> 14 Jul 1992 
— > July 
-> 19920714 
,DATE( 'I' )+21) -> 19920804 



SAY DATE( 'W, 19890609,' S') -» Friday 
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DATATYPEO DATATYPE(Zeichenfolge[,Option]) 

Wird nur das Argument "Zeichenfolge" angegeben, testet 
DATATYPEO, ob der Zeichenfolgenparameter eine gultige Zahl ist 
und gibt entweder NUM oder CHAR zuruck. Ist auch ein 
Optionsschlusselwort angegeben, gibt der boolesche Riickgabewert 
AufschluB dariiber, ob die Zeichenfolge dem angegebenen Typ 
entspricht. Folgende Optionsschliisselworter werden erkannt: 



ALPHANUMERIC 


Atphabetische (A-Z, a-z, Umlaute, B) und 




numerische (0-9) Zeichen 


BINARY 


Binare Ziffernfolge 


LOWERCASE 


Kleinbuchstaben (a-z, a, 6, u) 


MIXED 


GroB- und Kleinbuchstaben 


NUMERIC 


Gultige Zahlen 


SYMBOL 


Gultige REXX-Symbole 


UPPER 


GroBbuchstaben (A-Z, A, 0, 0, B) 


WHOLE 


Ganze Zahlen 


X 


Hexadezimale Ziffernfolgen 



Beispiel: 

SAY DATATYPE ( ' 123 ' ) -> NUM 
SAY DATATYPE ( ' la f 2 ' , ' X ' ) -» 1 
SAY DATATYPE ( ' aBcde ' , ' L ' ) ^0 



DELSTRO 



DELSTR(Zeichenfolge,n[,Lange]) 



Loscht den Teil des Arguments "Zeichenfolge", der mit dem n-ten 
Zeichen beginnt und aus der mit "Lange" angegebenen Anzahl 
Zeichen besteht. Standardlange ist die verbleibende Lange der 
Zeichenfolge. Beispiel: 



SAY DELSTR( '123456' ,2,3) 



-> 156 
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DELWORDO DELWORD(Zeichenfolge,n[,Lange]) 

Loscht den Teil des Arguments "Zeichenfolge", der mit dem n-ten 
Wort beginnt und aus der mit "Lange" angegebenen Anzahl Worter 
besteht. Standardlange ist der komplette Rest der Zeichenfolge. Zur 
gekxirzten Zeichenfolge gehoren auch alle dem letzten Wort 
nachgestellten Leerzeichen. Beispiel: 

SAY DELWORD(*Saq mir was Nettes ' , 2 , 2 ) -» 'Sag 

Nettes ' 

SAY DELWORD ( ' eins zwei drei',3) — » 'eins zwei ' 



DIGITSO DIGITSO 

Gibt die aktuelle Vorgabe for NUMERIC DIGITS zuruck. Beispiel: 

NUMERIC DIGITS 6 
SAY DIGITS ( ) -» 6 

EOF() EOF(Datei) 

Priift die angegebene logische Datei und gibt den booleschen Wert 1 
(Wahr) zuruck, wenn das Dateiende erreicht ist, andernfalls 
(Falsch). Beispiel: 

SAY EOF(Eindatei) -> 1 

ERRORTEXTO ERRORTEXT(n) 

Gibt den dem angegebenen ARexx-Fehlercode zugehorigen Fehler- 
meldungstext zuruck. Ist die Zahl kein giiltiger Fehlercode, wird 
eine leere Zeichenfolge zurlickgegeben. Beispiel: 

SAY ERRORTEXT{41) -> Invalid expression 

(Ungiiltiger Ausdruck) 
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EXISTSO EXISTS(Dateiname) 

Testet, ob eine externe Datei mit dem angegebenen Namen 
existiert. Der Name kann auch Gerate- und Verzeichnisangaben 
enthalten. Beispiel: 

SAY EXISTS ( 'SYS: C/ED' ) -^ 1 



EXPORTO EXPORT(Adresse[,Zeichenfolge][,Lange][,Fullzeichen]) 

Kopiert Daten aus der wahlfreien Zeichenfolge in den zuvor 
reservierten Speicherbereich. Dieser Speicherbereich muB in Form 
einer 4-Byte-Adresse angegeben werden. Das Langenargument 
bezeichnet die maximale Anzahl zu kopierender Zeichen. Standard- 
wert ist die Lange der Zeichenfolge. 1st die angegebene Lange 
grofler als die der Zeichenfolge, wird der restliche Bereich mit dem 
Fiillzeichen oder mit Nullzeichen (Wx) aufgefullt. Der Riickgabe- 
wert gibt die Anzahl der kopierten Zeichen an. 



Achtung Jeder beliebige Speicherbereich kann uberschrieben 
werden, was eventuell einen Systemabsturz zur Folge 
hat. Taskwechsel werden wahrend des Kopiervorgangs 
unterbunden, so da() die Systemleistung beim Kopieren 
langer Zeichenfolgen moglicherweise sinkt. 

Siehe auch IMPORTO und STORAGE(). Beispiel: 

anzahl = EXPORT ('0004 0000 'x, 1 Die Antwort ' ) 



FORMO FORMO 

Gibt die aktuelle Vorgabe fiir NUMERIC FORM zunick. Beispiel: 

NUMERIC FORM SCIENTIFIC 
SAY FORM() -^ SCIENTIFIC 
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FINDO FIND(Zeichenfolge,Phrase) 

Die Funktion FIND() sucht eine Phrase aus mehreren Wortern in 
einer Wortfolge und gibt die Wortnummer des Anfangs der Uberein- 
stimmung zuriick. Beispiel: 

SAY FIND( 'Nun ist es Zeit ' , * ist es ' ) -^2 



FREESPACEO FREESPACE (Adresse, Lange) 

Gibt einen Speicherblock mit der vorgegebenen Lange an den 
internen Pool des Interpreters zuriick. Das Argument 'Adresse" 
muB eine 4 Byte lange Zeichenfolge sein, die man durch einen 
vorherigen Aufruf der internen Zuordnungsfunktion GETSPACEO 
erhalten hat. Es ist nicht immer erforderlich, intern reservierten 
Speicherplatz freizugeben, da dieser bei Beendigung des Programms 
dem System sowieso wieder zu Verfugung gestellt wird. Wurde 
jedoch ein sehr groBer Speicherblock reserviert, kann seine Riick- 
gabe an den Pool moglichen Speicherplatz-Problemen vorbeugen. 
Der Riickgabewert ist ein boolesches Erfolgskennzeichen. Ver- 
gleichen Sie dazu auch die Funktion GETSPACEO: 

Zum Beispiel: 

SAY FREESPACE ( ' 00042 00 ' x, 32 ) -» 1 

Wird die Funktion FREESPACEO ohne Argumente aufgerufen, 
dann wird der im internen Pool des Interpreters verfugbare 
Speicherplatz zuriickgegeben. 



FUZZO FUZZO 

Gibt die aktuelle Vorgabe fur NUMERIC FUZZ zuriick. Beispiel: 

NUMERIC FUZZ 3 
SAY FUZZO -> 3 
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GETCLIPO GETCLIP(Name) 

Durchsucht die Clip-Liste nach einem Eintrag, der dem angege- 
benen Argument "Name" entspricht, und gibt die diesem Parameter 
zugeordnete Wertzeichenfolge zuriick. Bei diesem Namensabgleich 
wird nicht zwischen GroB- und Kleinschreibung unterschieden. 
Wenn der Name in der Clip-Liste nicht gefunden wird, wird eine 
leere Zeichenfolge zuriickgegeben (siehe auch SETCLIPO). Beispiel: 

/*Angenoinmen * Zahlen' enthalt ' PI = 3 .14159 ' */ 
SAY GETCLIP( 'Zahlen' ) -» PI=3. 14159 



GETSPACEO GETSPACE(Lange) 

Reserviert einen Speicherblock der angegebenen Lange aus dem 
internen Pool des Interpreters. Der Riickgabewert ist die 4-Byte- 
Adresse des reservierten Blocks, der weder geloscht noch auf andere 
Weise initialisiert wird. Sobald das ARexx-Programm beendet wird, 
wird der interne Speicher automatisch wieder dem System zur 
Verfugung gestellt. Daher sollte die Funktion nicht verwendet 
werden, um Speicherplatz fur externe Programme zu reservieren. 
Die Unterstiitzungsbibliothek (REXXSupport.Library) enthalt die 
Funktion ALLOCMEMO, die Speicherplatz aus der Liste fur freien 
Systemspeicher reserviert (siehe auch FREESPACEQ). Beispiel: 

SAY C2X(GETSPACE(32) ) -> '0003BF40'x 



HASHO HASH(Zeichenfolge) 

Gibt das Hash-Attribut einer Zeichenfolge als Dezimalzahl zuriick 
und aktualisiert den internen Hash- Wert der Zeichenfolge. Beispiel: 

SAY HASH( •!' ) ^49 
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IMPORTO IMPORT(Adresse[,Lange]) 

Diese Funktion erstellt eine Zeichenfolge, indem sie Daten ab einer 
angegebenen 4-Byte-Adresse kopiert. Wird kein Argument "Lange" 
angegeben, endet der Kopiervorgang, sobald ein Byte mit dem Wert 
Null gefunden wird (siehe auch EXPORTO). Beispiel: 

extval = IMPORT ('00 04 0000' x, 8) 

INDEXO INDEX(Zeichenfolge,Muster[,Start]) 

Sucht nach dem ersten Vorkommen des Arguments "Muster" im 
Argument "Zeichenfolge", beginnend an der angegebenen Startposi- 
tion. Standardmaflige Startposition ist 1. Der Riickgabewert ist der 
Index der mit dem Muster ubereinstimmenden Zeichenfolge oder 0, 
wenn das Muster nicht gefunden wurde. Beispiel: 



SAY INDEX ( 


'123456", "23") -» 2 


SAY INDEX ( 


'123456" , "77") -» 


SAY INDEX ( 


'123123", "23", 3) -» 5 


INSERTO 


INSERT(neu,alt[ 



Fligt nach der angegebenen Startposition die neue Zeichenfolge in 
die alte Zeichenfolge ein, Standardmafiige Startposition ist 0. Die 
neue Zeichenfolge wird je nach Bedarf auf die angegebene Lange 
abgeschnitten oder aufgefullt (mit dem angegebenen Fiillzeichen 
oder mit Leerzeichen). Liegt die Startposition hinter dem Ende der 
alten Zeichenfolge, wird die alte Zeichenfolge rechts aufgefullt. 
Beispiel: 

SAY INSERT( ' ab ' , ' 12345 ' ) -> abl2345 

SAY INSERT ( ' 12 3 ' , ' + + ' , 3 , 5 , ' - ' ) -» + + -12 3-- 
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LASTPOSO LASTPOS(Muster,Zeichenfolge[,Start]) 

Sucht riickwarts nach dem ersten Vorkommen des angegebenen 
Musters im Argument "Zeichenfolge", beginnend an der angege- 
benen Startposition. StandardmaBige Startposition ist das Ende der 
Zeichenfolge. Der Riickgabewert ist der Index der mit dem Muster 
ubereinstimmenden Zeichenfolge oder 0, wenn das Muster nicht 
gefunden wurde. Beispiel: 

SAY LASTPOS ( ' 2 ' , ' 1234 ' ) -^ 2 

SAY LASTPOS ( '2 ' , '1234234' ) -^ 5 

SAY LASTPOS ( '2 ' , ' 123234 ' ,3) -» 2 

SAY LASTPOS ( '2 ' , '13579' ) -> 



LEFTO LEFT(Zeichenfolge,Lange[,Fullzeichen]) 

Diese Funktion gibt die am weitesten links stehende Teil- 
zeichenfolge aus dem angegebenen Argument "Zeichenfolge" mit der 
angegebenen Lange zurlick. Ist die Teilzeichenfolge klirzer als die 
angeforderte Lange, wird sie rechts mit dem angegebenen Fiill- 
zeichen oder mit Leerzeichen aufgefiillt. Beispiel: 

SAY LEFT( '123456' ,3) -> 123 

SAY LEFT( '123456' ,8, ' + ' ) -^ 12 345 6 + + 



LENGTHO LENGTH(Zeichenfolge) 

Gibt die Lange der Zeichenfolge zuruck. Beispiel: 

SAY LENGTH ( 'drei' ) -^ 4 
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LINESO LINES(Datei) 

Gibt an, wieviele Zeilen einer logischen Datei in der Warteschlange 
stehen oder bereits eingegeben wurden, wobei sich die logische 
Datei auf einen interaktiven Datenstrom beziehen muG. Die Zeilen- 
zahl ergibt sich als Sekundarergebnis des Aufrufs WaitForChar(). 
Beispiel: 

PUSH 'eine Zeile' 

PUSH 'noch eine' 

SAY LINES (STDIN) -> 2 



MAXO MAX(Zahl,Zahl[,Zahl, ...])' 

Gibt den hochsten Wert der angegebenen Argumente zuriick. Alle 
Argumente miissen numerisch sein, und es miissen mindestens zwei 
Parameter angegeben werden. Beispiel: 

SAY MAX (2 .1,3,-1) -» 3 



MINO MIN(Zahl,Zahl[,Zahl, . . . ]) 

Gibt den niedrigsten Wert der angegebenen Argumente zuriick. Alle 
Argumente miissen numerisch sein, und es miissen mindestens zwei 
Parameter angegeben werden. Beispiel: 

SAY MIN(2 .1,3,-1) -» -1 



OPENO OPEN(Datei,Dateiname[,'APPEND' I 'READ' I 'WRITE']) 

Offnet eine externe Datei fur die angegebene Operation. Das 
Zeichenfolgenargument "Datei" definiert den logischen Namen, 
unter dem auf die Datei verwiesen wird. Der "Dateiname" ist der 
DOS-Name der Datei und kann sowohl Gerate- als auch Verzeich- 
nisangaben enthalten. Die Funktion gibt einen booleschen Wert 
zuriick, der dariiber AufschluB gibt, ob die Operation erfolgreich 
ausgefiihrt wurde. Die Anzahl gleichzeitig geoffneter Dateien ist 
theoretisch unbegrenzt. Bei Verlassen des Programms werden alle 
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geoffneten Dateien automatisch geschlossen (siehe auch CLOSEO, 
READO und WRITEO). Beispiel: 

SAY OPEN( 'MeinCon' , 'CON: 160/5 0/32 0/100 /MeinCon/cds ' ) 

-» 1 

SAY OPEN ( ' Ausgabe ' , ' ram : temp ' , ' W ' ) -» 1 

OVERLAYO OVERLAY(neu,alt[,Start][ ? Lange][,Fullzeichen]) 

tjberlagert die alte Zeichenfolge ab der angegebenen Startposition 
mit der neuen Zeichenfolge. Die Startposition muB ein positiver 
Wert sein. StandardmaBige Startposition ist 1. Die neue Zeichen- 
folge wird bei Bedarf abgeschnitten oder mit dem angegebenen 
Fullzeichen oder mit Leerzeichen bis zur angegebenen Lange 
aufgefiillt. Liegt die Startposition hinter dem Ende der alten 
Zeichenfolge, wird die alte Zeichenfolge rechts aufgefiillt. Beispiel: 

SAY OVERLAY ( ' bb ' , ' abed ' ) -» bbed 

SAY OVERLAY ( '4' , '123 ' ,5,5, '-' ) -» 123-4 

POSO POS(Muster,Zeichenfolge[,Start]) 

Sucht nach dem ersten Vorkommen des Arguments "Muster" im 
Argument "Zeichenfolge", beginnend an der im Argument "Start" 
angegebenen Position. StandardmaBige Startposition ist 1. Der 
Riickgabewert ist der Index der mit dem Muster liberein- 
stimmenden Zeichenfolge oder 0, wenn das Muster nicht gefunden 
wurde. Beispiel: 

SAY POS( '23 \ '123234 ' ) -> 2 

SAY POS( '77 ■', '123234' ) -» 

SAY POS( '23 * , '123234' ,3) -» 4 
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PRAGMAO 



PRAGMA(Option[,Wert]) 



Diese Funktion ermbglicht einem Programm die Anderung verschie- 
dener Attribute, die sich auf die Systemumgebung beziehen, in der 
das Programm ausgefuhrt wird. Das Argument "Option" ist ein 
Schlusselwort, das ein Umgebungsattribut angibt. Das Argument 
"Wert" bezeichnet den neu zu setzenden Attributwert. Der von der 
Funktion zuriickgegebene Wert hangt vom gewahlten Attribut ab. 
Einige Attribute geben den zuvor giiltigen Wert zurtick, andere 
lediglich einen booleschen Wert, der liber Erfolg oder Scheitern der 
Operation Auskunft gibt. 

Die zur Zeit definierten Optionsschliisselworter sind: 

DIRECTORY Gibt ein neues aktuelles Verzeichnis an. Das aktuelle 

Verzeichnis gilt als Bezug fur Dateinamen, die keine explizite 
Gerateangabe enthalten. Ruckgabewert ist der Name des 
alten Verzeichnisses. PRAGMA('D') entspricht 
PRAGMACD',""). Damit wird der Pfadname des aktuellen 
Verzeichnisses zuruckgegeben, ohne das Verzeichnis zu 
wechseln. 

PRIORITY Gibt eine neue Task-Prioritat an. Der Prioritatswert mu(3 eine 

ganze Zahl im Bereich von -128 bis 127 sein, in der Praxis 
ist dieser Bereich allerdings wesentiich enger gefaBt. ARexx- 
Programme sollten in keinem Fall eine hohere Prioritat 
erhalten als der residente ProzeB, der zur Zeit mit Prioritat 4 
ausgefuhrt wird. Der Ruckgabewert ist die zuvor gultige 
Prioritatsstufe. 

ID Gibt die Task-ID (die Adresse des Task-Blocks) in Form 

einer hexadezimalen 8-Hexziffern-Zeichenfolge zuruck. Die 
Task-ID ist eine eindeutige Kennung fur den jeweiligen 
ARexx-Aufruf und kann verwendet werden, urn aus diesem 
einen eindeutigen (Datei)Namen zu generieren. 

STACK Gibt eine neue StackgroBe fur das aktuelle ARexx-Programm 

an. Wenn eine neue StackgroBe festgelegt wird, wird der alte 
Wert zuruckgegeben. 
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Funktionen 



Die zur Zeit implementierten Optionen sind: 



PRAGMAfW'^NULLI 
'WORKBENCH'}) 



PRAGMA('*'[,Name]) 



SAY PRAGMA ( ' 
SAY PRAGMA ( ' 
SAY PRAGMA ( ' 
SAY PRAGMA ( ' 
CALL PRAGMA 
SAY PRAGMA ( ' 



Steuert das Feld WindowPtr der Task. Die 
Einstellung auf 'NULL' unterdruckt alle 
Dialogfenster, die ansonsten durch einen DOS- 
Aufruf generiert werden konnten. 

Deftniert den angegebenen logischen Namen als 
aktuellen Konsolen-Handler ("*"). Damit kann der 
Benutzerzwei Datenstrome innerhalb eines 
Fensters offnen. Wird der Name weggelassen, 
erhalt der Konsolen-Handler den Namen des 
Klientenprozesses. 

D' , ' DF0:C* ) -» Extras 

D ' , ' DF1 : C ' ) -» Workbench : C 

PRIORITY' ,-5) -^ 

ID' ) -» 00221ABC 

' * ' , STDOUT 

STACK" ,8092) -» 4000 



RANDOMO 



RANDOM([MIN][,MAX][,Ausgangszahl]) 



Gibt eine ganzzahlige Pseudo-Zufallszahl aus dem mit den 
Argumenten MIN und MAX festgelegten ganzzahligen Werte- 
bereich zuriick. Die Standardwerte sind (Minimum) und 999 
(Maximum). Das Intervall Max-Min muB kleiner oder gleich 1000 
sein. 1st ein groBerer Wertebereich fur die Zufallszahlen erforder- 
lich, konnen die Werte der Funktion RANDUO entsprechend 
skaliert und umgewandelt werden. Das Argument "Ausgangszahl" 
kann angegeben werden, um den internen Status des Zufalls- 
zahlengenerators zu initialisieren (siehe auch RANDUO). Beispiel: 

dieserwurf = RANDOM (1,6) /*K6nnte 1 sein*/ 

neuerwurf = RANDOM (1,6) /*2 Augen?*/ 



RANDUO 



RANDU([Ausgangszahl]) 



Gibt eine gleichmaBig verteilte Pseudo-Zufallszahl im Bereich von 
bis 1 zuriick. Die Anzahl der die Genauigkeit bestimmenden 
Dezimalstellen ist stets gleich der Vorgabe fur Numeric Digits. Mit 
der Auswahl geeigneter Skalierungs- und Umsetzungswerte kann 
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RANDUO verwendet werden, um Pseudo-Zufallszahlen in einem 
beliebigen Intervall zu generieren. 

Das wahlfreie Argument "Ausgangszahl" kann angegeben werden, 
um den internen Status des Zufallszahlengenerators zu initiali- 
sieren (siehe auch RANDOMO). Beispiel: 

erstversuch = RANDUO /*0 . 371902021?*/ 

NUMERIC DIGITS 3 

nochmal = RANDUO /*0.873?*/ 



READCHO READCH(Datei,Lange) 

Liest die angegebene Anzahl Zeichen aus der angegebenen 
logischen Datei in eine Zeichenfolge ein. Die Lange der zuriick- 
gegebenen Zeichenfolge entspricht der Anzahl tatsachlich gelesener 
Zeichen und kann auch kleiner sein als die angeforderte Lange, 
z. B. wenn das Dateiende erreicht wurde (siehe auch READLNO). 
Beispiel: 

zeile = READCH( ' Eingabe ' , 10) 



READLNO READLN(Datei) 

Liest Zeichen aus der angegebenen logischen Datei in eine 
Zeichenfolge ein, bis ein Zeichen fur Zeilenvorschub festgestellt 
wird, also eine komplette Zeile. Die zuruckgegebene Zeichenfolge 
enthalt das Zeichen fur Zeilenvorschub nicht (siehe auch 
READCHO). Beispiel: 

zeile = READLN( 'MeinDatei ' ) 
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REMLIBO REMLIB(Name) 

Entfernt einen Eintrag mit dem angegebenen Namen aus der 
Bibliotheksliste, dievom residenten Prozefl verwaltet wird. Wenn 
der Eintrag gefunden und erfolgreich entfernt wurde, wird der 
boolesche Wert 1 zuriickgegeben. Diese Funktion unterscheidet 
nicht zwischen Funktionsbibliotheken und Funktions-Hosts, 
sondern entfernt einfach den angegebenen Eintrag (siehe auch 
ADDLIBO). Beispiel: 

SAY REMLTB ( ' MeineLibrary . Library ' ) , —> 1 



REVERSEO REVERSE(Zeichenfolge) 

Kehrt die Reihenfolge der Zeichen in der Zeichenfolge urn. Beispiel: 

SAY REVERSE (' ?thcin muraW ' ) -» Warum nicht? 

RIGHTO RIGHT(Zeichenfolge,Lange[ ? Fullzeichen]) 

Diese Funktion gibt die am weitesten rechts stehende Teilzeichen- 
folge aus dem angegebenen Argument "Zeichenfolge" mit der ange- 
gebenen Lange zurlick. 1st die Teilzeichenfolge kiirzer als die ange- 
forderte Lange , wird sie links mit dem angegebenen Fiillzeichen 
oder mit Leerzeichen aufgefullt. Beispiel: 

SAY RIGHT( '123456' ,4) . -> 3456 

SAY RIGHT ( ' 12 3456' , 8, '+' ) -^ + + 12 3 456 



SEEKO SEEK(Datei,Offset[,'BEGIN' I 'CURRENT' I 'END']) 

Geht zu einer neuen Position in der angegebenen logischen Datei. 
Die neue Position wird als Abstand (Offset) bezogen auf eine Anker- 
position (drittes Argument) angegeben. StandardmaBige Anker- 
position ist die aktuelle Position (CURRENT). Der Riickgabewert ist 
die neue Position bezogen auf den Dateianfang. Beispiel: 

SAY SEEKCEingabeMO, 'B') -» 10 

SAY SEEK( 'Eingabe' , 0, 'E' ) -> 356 / *Dateilange* / 
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SETCLIPO SETCLIP(Name[,Wert]) 

Fiigt ein Name-Wert-Paar in die Clip-Liste ein, die vom residenten 
ProzeB verwaltet wird. Wenn ein Eintrag nut diesem Namen bereits 
existiert, wird sein Wert entsprechend der angegebenen Wert- 
zeichenfolge aktualisiert. Eintrage konnen durch Angabe eines 
Nullwertes (gar kein Argument) entfernt werden. Die Funktion gibt 
einen booleschen Wert zuriick, der AufschluB dariiber gibt, ob die 
Operation erfolgreich ausgefuhrt wurde. Beispiel: 

SAY SETCLIP ( ' Pfad' , ' DFO : s ' ) -» 1 

SAY SETCLIP (' Pfad' ) -» 1 



SHOWO SHOW(Option[,Name][,Fiillzeichen]) 

Gibt die eingetragenen Namen in der Ressourcenliste "Option" 
zuriick oder uberpruft, ob ein Eintrag mit dem angegebenen Namen 
vorliegt. Die zur Zeit implementierten Optionsschliisselworter sind: 

CLIP Uberpruft die Namen in der Clip-Liste. 

FILES Uberpruft die Namen der zur Zeit geoffneten logischen 

Dateien. 

LIBRARIES Uberpruft die Namen in der Bibliotheksliste, die weder 

Funktionsbibliotheken noch Funktions-Hosts bezeichnen. 

PORTS Uberpruft die Namen in der Liste der System-Ports. 

Wird das Argument "Name" weggelassen, gibt die Funktion eine 
Zeichenfolge mit den Ressourcennamen zuriick, jeweils getrennt 
durch Leerzeichen oder (falls eines definiert wurde) das angegebene 
Fullzeichen. Wird das Argument "Name" angegeben, gibt der 
zurtickgegebene boolesche Wert dariiber AufschluB, ob der Name in 
der Ressourcenliste gefunden wurde. Bei diesen Namenseintragen 
wird zwischen GroB- und Kleinschreibung unterschieden. 
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SIGNO SIGN(Zahl) 

Gibt 1 zuriick, wenn das Argument "Zahl" positiv oder Null ist, und 
-1, wenn die Zahl negativ ist. Das Argument mufl numerisch sein. 
Beispiel: 

SAY SIGN (12) -> 1 

SAY SIGN(-33) -» -1 



SOURCELINEO SOURCELINE([Zeile]) 

Gibt den Text der angegebenen Zeile des zur Zeit laufenden ARexx- 
Quellprogramms zuriick. Wenn das Argument "Zeile" weggelassen 
wird, gibt die Funktion die Gesamtzeilenzahl der Datei zuriick, 
Diese Funktion wird haufig verwendet, um Hilfeinformationen in 
ein Programm einzufugen. Beispiel: 

/*Ein einfaches Testprogramm*/ 

SAY SOURCELINEO -»■ 3 

SAY SOURCELINE(l) -» /*Ein einfaches Testprogramm*/ 



SPACEO SPACE(Zeichenfolge,n[,Fiillzeichen]) 

Formatiert das Argument "Zeichenfolge" so um, dafi zwischen 
jeweils 2 Wortern n Leerzeichen stehen. Wenn das Fiillzeichen 
angegeben wird, wird es anstelle von Leerzeichen als Trennzeichen 
verwendet. Wird fur n angegeben, werden alle Leerzeichen aus 
der Zeichenfolge entfernt. Beispiel: 

SAY SPACE ('Nun ist es Zeit' ,3) 

— > 'Nun ist es Zeit 1 
SAY SPACE (* Nun ist es Zeit',0) 

— » 'NunistesZeit ' 
SAY SPACE ( , 12 3M / , + l ) -^ '1 + 2 + 3 ' 
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STORAGEO STORAGE([Adresse][,Zeichenfolge][,Lange][,Fullz.]) 

Die Funktion STORAGEO ohne Argumente gibt den verfugbaren 
Systemspeicher zuriick. Wird das Argument "Adresse" angegeben, 
mufl dies in Form einer 4-Byte-Zeichenfolge geschehen. Die 
Funktion kopiert Daten aus der (wahlfrei anzugebenden) Zeichen- 
folge an die angegebene Speicheradresse. Der Parameter "Lange" 
bezeichnet die maximale Anzahl zu kopierender Bytes und hat 
standardmaBig die Lange der Zeichenfolge. 1st die angegebene 
Lange groBer als die Zeichenfolge, wird der verbleibende Rest mit 
dem Fiillzeichen oder mit Nullbytes COO'x) aufgefiillt. 

Der Riickgabewert bezeichnet den vorherigen Inhalt des Speicher- 
bereichs. Dieser kann in einem spateren Aufruf verwendet werden, 
um den ursprunglichen Inhalt wiederherzustellen (siehe auch 
EXPORTO). 

Vorsicht Jeder beliebige Speicherbereich kann uberschrieben 
werden, was eventuell einen Systemabsturz zur Folge 
hat. Taskwechsel werden wahrend des Kopiervorgangs 
unterbunden, so daB die Systemleistung beim Kopieren 
langer Zeichenfolgen moglicherweise sinkt. 

Beispiel: 

SAY STORAGEO -> ' 248400 

altinhalt - STORAGE (' 0004 0000' x, ' Die Antwort ' ) 

CALL STORAGE '0004 0000' x,, 32,'+' 
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STRIPO STRIP(Zeichenfolge[,{'BM L' I T}][,Fullzeichen]) 

Wird keines der wahlfrei zu verwendenden Argumente angegeben, 
entfernt die Funktion sowohl voran- als auch nachgestellte Leer- 
zeichen aus dem Argument "Zeichenfolge". Das zweite Argument 
gibt an, ob nachgestellte (T - trailing), vorangestellte (L - leading) 
oder beide Arten von Leerzeichen (B - both) entfernt werden sollen. 
Das wahlfrei anzugebende "Fullzeichen" bezeichnet das zu ent- 
fernende Zeichen. Beispiel: 

SAY STRIP (' Wie bitte? ') -^ Wie bitte? 
SAY STRIP ( ' Wie bitte? ' , ' L ' ) -» Wie bitte? 
SAY STRIP ( '++12 3+++' , 'B 1 , ' + ' ) -» 12 3 



SUBSTRO SUBSTR(Zeichenfolge,Start[,Lange][,Fullzeichen]) 

Gibt eine Teilzeichenfolge des Arguments "Zeichenfolge" zuriick, die 
an der angegebenen Startposition beginnt und die angegebene 
Lange hat. Die Startposition mufl eine positive Zahl sein. Als 
Standardlange gilt der komplette Rest der Zeichenfolge. 1st die 
Teilzeichenfolge kiirzer als die angeforderte Lange, wird sie rechts 
mit Leerzeichen oder dem angegebenen Fullzeichen aufgefullt. 
Beispiel: 

SAY SUBSTR{ '123456 ' ,4,2) -» 45 

SAY SUBSTR ( ' meinname ' , 5 , 6 , ' = ' ) -> name= = 



SUBWORDO SUBWORD(Zeichenfolge,n[,Lange]) 

Gibt eine Teilzeichenfolge des Arguments "Zeichenfolge" zuriick, die 
mit dem n-ten Wort beginnt und deren Wortanzahl im Argument 
"Lange" definiert ist. Als Standardlange gilt die restliche Lange der 
Zeichenfolge. Die zuriickgegebene Zeichenfolge hat in keinem Fall 
voran- oder nachgestellte Leerzeichen. Beispiel: 

SAY SUBWORD('Nun ist es Zeit ',2,2) -» ist es 
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SYMBOLO SYMBOL(Name) 

Uberpriift, ob das Argument "Name" ein giiltiges ARexx-Symbol ist. 
1st dies nicht der Fall, gibt die Funktion die Zeichenfolge BAD 
zuriick. Ist das Symbol nicht initialisiert, lautet die zuriickgegebene 
Zeichenfolge LIT. Ist dem Symbol ein Wert zugeordnet, wird VAR 
zuriickgegeben. Beispiel: 



SAY 


SYMBOL ( 


'J'} 


-» VAR 


SAY 


SYMBOL { 


' x' ) 


-» LIT 


SAY 


SYMBOL ( 


'++' ) 


-> BAD 



TIMEO TIME(Option) 

Gibt die aktuelle Systemzeit zuriick oder steuert die interne Lauf- 
zeitmessung. Giiltige Optionsschliisselworter sind: 

CIVIL Aktuelle Zeit im 12-Stunden-Format (a.m./p.m.) 

Stunde/Minuten 

ELAPSED Seit dem Programmstart vergangene Zeit in Sekunden 
HOURS Aktuelle Zeit in Stunden seit Mitternacht 

MINUTES Aktuelle Zeit in Minuten seit Mitternacht 

NORMAL Aktuelle Zeit im 24-Stunden-Format 

(Stunden/Minuten/Sekunden) 

RESET Setzt die Laufzeitmessung zuriick 

SECONDS Aktuelle Zeit in Sekunden seit Mitternacht 

Wird keine Option angegeben, gibt die Funktion die aktuelle 
Systemzeit im Format HH:MM:SS zuriick. Beispiel: 

/*Angenominen, es ist 1:02 Uhr nachts . . .*/ 

SAY TIME('C') -^ 1:02 AM 

SAY TIME { 'HOURS' ) -» 1 

SAY TIME{ 'M' ) ^62 

SAY TIME('N') -> 01:02:54 

SAY TIME( ' S' ) -» 3720 

call TIME('R') / *Lauf zeitmessung zurucksetzen*/ 

SAY TIME( 'E' ) -> .02 

SAY TIMEO -^ 01:02 : 00 
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TRACEO TRACE(Option) 

Stellt den Ablaufverfolgungsmodus (siehe Kapitel 6.1) entsprechend 
dem Schliisselwort "Option" ein. Dafur mufl eine der zulassigen 
alphabetischen oder Prafixoptionen verwendet werden. Die Funk- 
tion TRACEO andert den Ablaufverfolgungsmodus auch wahrend 
einer interaktiven Ablaufverfolgung. In diesem Fall werden 
TRACE-Befehle im Quellprogramm ignoriert Riickgabewert ist der 
vor dem Funktionsaufruf aktive Modus. Dies ermoglicht die spatere 
Wiederherstellung des vorherigen Ablaufverfolgungsmodus. 
Beispiel: 

/*Angenommen, der Ablaufverfolgungsmodus ist ?ALL*/ 
SAY TRACE ( 'Results' ) -» ?A 



TRANSLATEO TRANSLATE(Zeichenfolge[,AusgJ[,Eing.][,Fullz.]) 

Diese Funktion erstellt eine Umsetztabelle und ersetzt auf der Basis 
dieser Tabelle ausgewahlte Zeichen aus dem Argument "Zeichen- 
folge". Wird nur das Argument "Zeichenfolge" angegeben, so wird es 
in GroBbuchstaben umgesetzt. Bei Angabe einer Eingabetabelle 
wird die Umsetztabelle verandert, so dafl Zeichen im Argument 
"Zeichenfolge", die in der Eingabetabelle vorkommen, durch die 
entsprechenden Zeichen in der Ausgabetabelle ersetzt werden. 
Zeichen, die uber das Ende der Ausgabetabelle hinausgehen, 
werden durch das angegebene Fullzeichen oder durch Leerzeichen 
ersetzt. Die resultierende Zeichenfolge ist stets genau so lang wie 
die urspriingliche Zeichenfolge. Die Ein- und Ausgabetabellen 
konnen beliebig lang sein. Beispiel: 

SAY TRANSLATE ( "abode" , "123", "cbade", "+") -> 321++ 

SAY TRANSLATE ("klein") -^ KLEIN 

SAY TRANSLATE ("0110" , "10", "01" ) -» 1001 



TRIMO TRIM(Zeichenfolge) 

Entfernt nachgestellte Leerzeichen aus dem Argument "Zeichen- 
folge". Beispiel: 

SAY length (TRIM ( ' abc ')) ^4 
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TRUNCO TRUNC(Zahl[,Stellen]) 

Gibt den ganzzahligen Teil des Arguments "Zahl", gefolgt von der 
angegebenen Anzahl Dezimalstellen zuriick. Standardwert fur die 
Dezimalstellen ist 0. Die Zahl wird bei Bedarf mit Nullen aufgefiillt. 
Beispiel: 

SAY TRUNC(123.456) -> 123 

SAY TRUNC(123.456,4) -> 123.4560 



UPPERO UPPER(Zeichenfolge) 

Setzt die Zeichenfolge in GroBbuchstaben um. Diese Funktion hat 
den gleichen Effekt wie die Funktion TRANSLATE(Zeichenfolge), 
nur ist sie bei kurzen Zeichenfolgen etwas schneller. Beispiel: 

SAY UPPER ('Ein schoner Tag') -> EIN SCHONER TAG 



VALUEO VALUE(Name) 

Gibt den Wert des Symbols zuriick, das im Argument "Name" 
dargestellt ist. Beispiel: 

/*Angenommen, J hat den Wert 12*/ 
SAY VALUE ( ' j ' ) -> 12 



VERIFYO VERIFY(Zeichenfolge,Liste[/MATCH']) 

Gibt die Indexposition des ersten Zeichens im Argument "Zeichen- 
folge" zuriick, das nicht im Argument "Liste" enthalten ist, oder 0, 
wenn alle Zeichen in der Liste stehen. Wird das Schltisselwort 
MATCH angegeben, gibt die Funktion die Indexnummer des ersten 
Zeichens im Argument "Zeichenfolge" zuriick, das im Argument 
"Liste" enthalten ist, oder 0, wenn keines der Zeichen in der Liste 
stent. Beispiel: 

SAY VERIFY ( ' 123456 ' , ' 012 3456789 * ) -> 

SAY VERIFY ( '12 3a5 6' , ' 012 3 45 67 89 * ) -H> 4 
SAY VERIFY ( ' 123a45 ' , ' abcdefghij ' , ' m ' ) -> 4 
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WORDO WORD(Zeichenfolge,n) 

Gibt das n-te Wort aus dem Argument "Zeichenfolge" zuriick oder 
eine leere Zeichenfolge, wenn die Zeichenfolge weniger als n Worter 
hat. Beispiel: 

SAY WORD ('Nun ist es Zeit \2) -» ist 



WORDINDEXO WORDINDEX(Zeichenfolge,n) 

Gibt die Startposition des n-ten Worts im Argument "Zeichenfolge" 
zuriick, oder 0, wenn die Zeichenfolge weniger als n Worter hat. 
Beispiel: 

SAY WORDINDEX( 'Nun ist es Zeit ' ,3) ^9 



WORDLENGTHO WORDLENGTH(Zeichenfolge,n) 

Gibt die Lange des n-ten Worts im Argument "Zeichenfolge" zuriick. 
Beispiel: 

SAY WORDLENGTH( 'vier fiinf sechs ' , 3 ) -» 5 



WORDS0 WORDS(Zeichenfolge) 

Gibt die Anzahl der Worter im Argument "Zeichenfolge" zurtick, 
Beispiel: 

SAY WORDS ( "Wie geht ' ' s Dir? " ) ^3 



WRITECHO WRITECH(Datei,Zeichenfolge) 

Schreibt das Argument "Zeichenfolge" in die angegebene logische 
Datei. Der Riickgabewert ist die Anzahl der geschriebenen Zeichen. 
Beispiel: 

SAY WRITECH ( ' Ausgabe ' , ' Test * ) ^4 
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WRITELNO WRITELN(Datei,Zeichenfolge) 

Schreibt das Argument "Zeichenfolge" in die angegebene logische 
Datei und fiigt ein Zeichen fur Zeilenvorschub an. Der Riickgabe- 
wert ist die Anzahl der geschriebenen Zeichen. Beispiel: 

SAY WRITELN( 'Ausgabe' , 'Test • ) -» 5 



X2C0 X2C(Zeichenfolge) 

Wandelt eine aus Hexadezimalziffern bestehende Zeichenfolge in 
die (gepackte) Zeichendarstellung um. Leerzeichen sind im 
Argument "Zeichenfolge" an Bytegrenzen zulassig. Beispiel: 

SAY X2C('12ab l ) -Vl2ab'x 

SAY X2C ( ' 12 ab ' ) -> ' 12ab ' >: 

SAY X2C(61) -> a 



X2D() X2D(Hex-Zeichenfolge) 

Wandelt eine Hexadezimalzahl in eine Dezimalzahl um. Beispiel: 

SAY X2D( ' If ' ) -> 31 

XRANGEO XRANGEf|"Start]I,Endel) 

Generiert eine Zeichenfolge, die aus alien Zeichen besteht, deren 
Codes numerisch zwischen den angegebenen Start- und Endzeichen 
liegen. Standardzeichen sind 'OO'x fiir Start und 'FF'x fiir Ende. Nur 
die jeweils ersten Zeichen der Argumente "Start" und "Ende" sind 
von Bedeutung. Beispiel: 

SAY XRANGEO -> '00010203 . . . FDFEFF ' x 

SAY XRANGE ( ' a ' , ' f ' ) -> ' abcdef ' 

SAY XRANGE{ , ' 0A'x)-> ' 000 102 03 040 5 6 07 080 9 0A * x 
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5.5.3 Programmbeispiel 

Das folgende Beispielprogramm illustriert viele der integrierten 
Funktionen, mit denen Zeichenfolgen manipuliert werden. 

Programm 13. Changestrings.rexx 

/*Dieses ARexx- Programm zeigt die Wirkung 
integrierter Funktionen, die Zeichenfolgen 
manipulieren. Die Funktionen lassen sich in zwei 
Gruppen einteilen: solche, die einzelne Zeichen 
verandern, und solche, die ganze Zeichenfolgen 
verandern. */ 

teststringl = " every good boy does fine 

/*Die erste Gruppe bilden die Funktionen STRIP(), 
COMPRESS ( ) , SPACE ( } , TRIM ( ) , TRANSLATE ( } , DELSTR ( ) , 
DELWORD ( ) , INSERT ( ) , OVERLAY ( ) und REVERSE ( ) . * / 

/*STRIP{) entfernt lediglich voran- und nachgestellte 
Leerzeichen. */ 

/ *Drucken Sie zu Vergleichszwecken die 
Originalzeichenfolge aus . Die Zeichenfolge wird mit 
einem Punkt abgeschlossen, damit Sie sehen, was mit 
den Leerzeichen am Ende der Zeichenfolge geschieht . */ 
SAY H every good boy does fine 

/*Die gleiche Zeichenfolge ohne voran- und nachgestellte 

Leerzeichen*/ 

SAY STRIP ( " every good boy does fine " ) " . M 

/*Gescheiterter Versuch, die voran- und nachgestellten 

"e"'s zu entfernen*/ 

SAY STRIP (" every good boy does fine 

" , , " e " ) " . " 

/*Die "e"'s waren durch die noch immer vorhandenen, 
voran- und nachgestellten Leerzeichen geschiitzt. 
Durch Loschen dieser Leerzeichen werden die "e"'s den 
Auswirkungen der Funktion STRIP () ausgesetzt*/ Ch ' 
SAY STRIP { "every good boy does f ine" , , " e" ) " . " 
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/*Nun wercien die "e"'s und die Leerzeichen aus der 
Original. zeichenf olge geloscht* / 

SAY STRIP (" every good boy does fine " , , " 
e") "." 

/*Nun wird die weiter oben definierte Variable 

" teststringl " verwendet , Entfernung nur der 

nachgestel] ten Leerzeichen aus der 

Test zeichenf olge . */ 

SAY STRIP (teststringl, T) " . " 

/ *Entf ernung der nachgestell-ten Leerzeichen und des 

" e " * / 

SAY STRIP ( teststringl, T, " e" ) " . " 

/^Compress ( ) entfernt Zeichen uberall innerhalb einer 
Zeichenf olge . Hier werden alle Leerzeichen aus der 

Test zeichenf olge teststringl geloscht*/ 

SAY COMPRESS (teststringl) 

CALL TIME( ' r ' ) 

SAY TIME ( 'Civil ' ) /*Uhrzeit HH:MM{AM I PM}*/ 

SAY TIME('h') /*Stunden seit Mitternacht * / 

SAY TIME('m') /*Minut.en seit Mi tternacht */ 

SAY TIME ( * s ' ) /*Sekunden sell Mi t tor. nacht * / 

SAY TIME('e') / *Vo.r gangene Zeit seit dem 
Programiustart * / 

/ *Funktion : TRACE Veiwendung : TRACE ( [ Opt i on J ) * / 

SAY TRACE ( ) 

SAY TRACE (TRACE () ) / *Unverandcr t lasson*/ 

/ * Punkt i on : TRANSLATE 

Verwendung : 

TRANSLATE ( Zeich . f olge [ 

SAY TRANSLATE ( ' aBCdef ' 

GroSbuchstaben* / 

SAY -TRANSLATE ( 'abcdef 

SAY TRANSLATE (' 654321' 

SAY TRANSLATE ( 'abcdef 



Ausgabe] [ , Emgabe] [,Fullz.J)*/ 
/*Umwandeln in 

, '1234' ) 

'abcdef* , '123456' ) 

'123 ' , 'abcdef , ' + ' ) 



/*Funktion: TRIM Verwendung: TRIM { Zeichenf olge) */ 

SAY TRIM ( ' abc ' ) 

/* Funk t ion : TRUNC Verwendung : 

TRUNC(Zahl[,Stellen] ) */ 

SAY TRUNC (123 .456) 

SAY TRUNC(134566.123,2) 'DM' 
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/*Funktion: UPPER Verwendung: UPPER ( Zeichenf olge) */ 
SAY UPPER ( 'aBCdefl2a6U' ) 

/ *Funktion : VALUE Verwendung : VALUE (Name ) * / 
abc = ' Mein Name' 
SAY VALUE ( • abc ' ) 

/ * Funkt ion: VERI FY Ve rwendung : 
VERIFY (Zeichenf olge ,Liste[, 'M' ] ) */ 
SAY VERIFY ( ' 123a45 ' , ' 0123456789 T ) 
SAY VERIFY ( 'abc3de' , ' 012456789 ' , 'M' ) 

/*Funktion: WORD Verwendung: WORD (Zeichenf olge, nj */ 
SAY WORD ('Nun ist es Zeit',3) 

/ * Funkt ion : WORDINDEX Verwendung : 

WORDINDEX ( Zeichenf olge , n) * / 

SAY WORDINDEX ( 'Nun ist es Zeit ',3) 

/* Funkt ion: WORDLENGTH Verwendung: 

WORDLENGTH ( Zeichenf olge , n) * / 

SAY WORDLENGTH (' Nun ist es Zeit ',4) 

/ *Funkt ion : WORDS Verwendung : WORDS ( Zeichenf olge ) * / 
SAY WORDS ('Nun ist es Zeit') 

/* Funkt ion: WRITECH Verwendung: 

WRITECH (Datei, Zeichenf olge) */ 

IF OPEN( 'test ' , 'ram: test $$ ' , 'W' ) THEN DO 

SAY WRITECH ( ' test ' , 'Hallo ' ) /* Zeichenf olge 

schreiben*/ 

CALL CLOSE ' test ' 

END 

/ * Funkt i on : WRI TELN Verwendung : 

WRITELN (Datei, Zeichenf olge) */ 

IF OPEN( 'test ' , 'ram:test$$ ' , 'W' ) THEN DO 

SAY WRITELN ( ' test ' , ' Hallo ' ) 

/* Zeichenf olge (plus Zeilenvorschubzeichen) 

schreiben*/ 

CALL CLOSE * test ' 

END 

/*Funktion: X2C Verwendung: X2C (hexadezimale 
Zeichenf olge) */ 

SAY' X2C (' 616263 ' ) /*Umwandeln in Zeichen 
(gepackt ) */ 
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/*Funktion: XRANGE Verwendung : 

XRANGE{ [Start] [,Ende] ) */ 

SAY C2X(xrange( ' f 'x) ) 

SAY XRANGE ( ' a ' , ' g ' ) 

EXIT 

Die Ausgabe des Testprogramms 13 sieht folgendermaflen aus: 

every good boy does fine 
every good boy ' does fine. 

every good boy does fine . 
very good boy does fin. 
very good boy does fin . 

every good boy does fine . 

every good boy does fin. 
every goodboy does f ine 

1:23PM /*Diese Testergebnisse hangen von der 
Uhrzeit ab, */ 

13 /*zu der Sie das Proqramm aufrufen. */ 
803 
48199 
0.80 
N 
N 

ABCDEF 
abcdef 
fedcba 
123+++ 
abc 
123 

134566.12 DM 
ABCDEF12 
Me in Name 
4 


es 
8 
4 
4 
7 
8 

abc 

F0F1F2F3F4F5F6F7F8F9FAFBFCFDFEFF 
abcdefg 
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5.6 Funktionen der Bibliothek 
REXXSupport.Library 

Die in diesem Abschnitt aufgelisteten Funktionen sind Teil der 
Bibliothek REXXSupport.library. Sie konnen nur verwendet 
werden, wenn diese Bibliothek geoffnet ist. Das folgende Beispiel 
zeigt, wie Sie diese Bibliothek offnen konnen. 

Programm 14. OpenLibrary.rexx 

/*Rexxsupport . library offnen, falls noch nicht 

geschehen. */ 

IF ~ SHOW PL', "rexxsupport . library" ) THEN DO 

/*Ist sie schon geoffnet? Wenn nicht, jetzt 

versuchen, sie zu offnen*/ 

IF ADDLIB{ ' rexxsupport .library * , 0, -30,0) 

THEN SAY "Rexxsupport . library geoffnet." 

ELSE DO 

SAY ' ARexx-Unterstiitzungsbibliothek nicht 
verfiigbar, Programm wird verlassen' 

EXIT 10 /*Bei Scheitern von ADDLIB ( ) wird das 
Programm verlassen*/ 

END 
END 



ALLOCMEMO ALLOCMEM(Lange[ ? Attribut]) 

Reserviert einen Speicherblock der angegebenen Lange aus dem 
Pool des freien Systemspeichers und gibt dessen Adresse in Form 
einer 4-Byte-Zeichenfolge zurlick. Der wahlfrei anzugebende Para- 
meter "Attribut" mufi eine standardmaBige EXEC-Kennung sein, 
die als 4-Byte-Zeichenfolge anzugeben ist. Standardattribut ist 1 fur 
"PUBLIC" fur allgemein zuganglichen (nicht vorher gelbschten) 
Speicher. Weitere Informationen liber Speichertypen und Attribut- 
parameter finden sie in der Beschreibung von Bibliotheken in den 
Amiga ROM Kernel Reference Manuals (offizielle Systemdokumen- 
tation fur Programmierer). 
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Diese Funktion sollten Sie immer dann verwenden, wenn Speicher- 
platz fur externe Programme reserviert werden soil. Die Freigabe 
von nicht mehr benotigtem Speicherbereich liegt in der Verant- 
wortung des Benutzers (siehe auch FREEMEMO). Beispiel: 

SAY C2X(ALLOCMEM(1000) ) -» 00050000 

SAY C2X(ALLOCMEM (1000, '00 01 00 l'X )) -» 00228400 
/*1000 Byte geCLEARter (auf gesetzter) allgemein 
zuganglicher Speicherplatz*/ 



CLOSEPORTO CLOSEPORT(Name) 

Schliefit den Message-Port, der im Argument "Name" angegeben 
wurde. Dieser mufi zuvor innerhalb des aktuellen ARexx- 
Programms mit dem Aufruf OPENPORTQ zugeordnet worden sein. 
Alle empfangenen Nachrichten, auf die noch nicht geantwortet 
(REPLY) wurde, werden automatisch mit dem Riickgabewert 10 
zuriickgegeben (siehe auch OPENPORTQ). Beispiel: 

CALL CLOSEPORT meinport 



FREEMEMO FREEMEM(Adresse,Lange) 

Gibt einen Speicherblock der angegebenen Lange frei (d. h. an den 
Pool des freien Systemspeichers zuriick). Das Argument "Adresse" 
ist eine 4-Byte-Zeichenfolge, die sich in der Regel aus einem vor- 
herigen Aufruf der Funktion ALLOCMEMO ergibt. FREEMEMO 
kann nicht zur Freigabe von Speicherplatz verwendet werden, der 
mit der internen ARexx-Speicherreservierungsfunktion GET- 
SPACEO reserviert wurde. Der Riickgabewert ist ein boolesches 
Erfolgskennzeichen (siehe auch ALLOCMEMO). Beispiel: 

Speicheranforderung = 1024 /* SpeichergroSe*/ 

MeinSp = ALLOCMEM ( Speicheranforderung) 

SAY C2X(MeinSp) -> 07C987B0 

SAY FREEMEM (MeinSp, Speicheranforderung) —> 1 

/*Oder : SAY FREEMEM ( ' 07C987B0 'x, 1024) */ 
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Achtung Vor AbschluR des Programms muB mit der Funktion 
FREEMEM() der zuvor mit ALLOCMEM() zugeordnete 
Speicherplatz wieder freigegeben werden. Andernfalls 
riskieren Sie einen Systemabsturz. Zumindest stunde 
aber der betreffende Speicherplatz erst nach dem 
nachsten Systemstart (Reboot) wieder zur Verfiigung. 



GETARGO GETARG(Paket[,n]) 

Extrahiert ein Kommando, einen Funktionsnamen oder eine Argu- 
mentzeichenfolge aus einem Nachrichtenpaket. Das Argument 
"Paket" mufi eine 4-Byte-Adresse sein, die sich aus einem 
vorherigen Aufruf der Funktion GETPKTO ergeben hat. Das 
wahlfreie Argument n bezeichnet die Position, an der die zu 
extrahierende Zeichenfolge stent, wobei n kleiner oder gleich der 
Gesamtzahl der Argumente in diesem Paket sein mufi. Befehle und 
Funktionsnamen befinden sich stets an Position 0. Funktionspakete 
konnen Argumentzeichenfolgen an den Positionen 1 bis 15 
aufweisen. Beispiel: 

Kommando = GETARG (Paket ) 

Funktion - GETARG ( Paket , ) /*Name Zeichenfolge*/ 

argl = GETARG ( Paket , 1 ) /*Erstes Argument*/ 



GETPKTO GETPKT(Name) 

Uberprlift, ob bei dem im Argument "Name" angegebenen Message- 
Port Nachrichten vorliegen. Der angegebene Message-Port muB 
zuvor innerhalb des aktuellen ARexx-Programms mit dem Aufruf 
OPENPORT0 gebffhet worden sein. Der zuriickgegebene Wert ist 
die 4-Byte-Adresse des ersten Nachrichtenpakets oder '0000 0000 x, 
wenn keine Pakete vorlagen. 
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Die Funktion meldet sofort, ob ein Paket in der Warteschlange des 
Message-Ports steht oder nicht. Programme sollten niemals so 
gestaltet sein, daft sie in einer engen Schleife permanent diese 
Abfrage aufrufen. Wenn das Programm bis zum Eintreffen des 
nachsten Nachrichtenpakets keine Aktionen auszufuhren hat, sollte 
es die Funktion WAITPKTO aufrufen und damit die Weiterbe- 
arbeitung anderer Tasks ermbglichen (siehe auch WAITPKTO). 
Beispiel: 

packet = GETPKT ( 'MeinPort ' ) 



OPENPORTO OPENPORT(Name) 

Erstellt einen allgemein zuganglichen Message-Port mit dem 
angegebenen Namen. Der zuriickgegebene boolesche Wert gibt Auf- 
schluB dariiber, ob der Port erfolgreich geoffhet wurde. Wenn 
bereits ein Port mit diesem Namen existiert oder ein Signalbit nicht 
reserviert werden konnte, kommt es zu einem Initialisierungfehler. 
Der Message-Port wird als "Port-Ressourcen-Knoten" angelegt und 
in die globale Datenstruktur des Programms integriert. Ports 
werden automatisch geschlossen, wenn das Programm verlassen 
wird, und alle noch nicht verarbeiteten Meldungen werden an die 
Absender zuruckgeschickt (siehe auch CLOSEPORTO). Beispiel: 

erfolg - OPENPORT { "MeinPort " ) 



REPLYO REPLY(Paket,rc) 

Schickt ein Nachrichtenpaket an den Absender zuriick, wobei das 
Primarergebnisfeld auf den im Argument "re" (Return Code) 
angegebenen Wert gesetzt wird. Das Sekundarresultat wird 
gelbscht. Das Argument "Paket" ist in Form einer 4-Byte-Adresse 
anzugeben, fur "RC" ist eine ganze Zahl anzugeben. Beispiel: 

CALL REPLY (Paket, 10) / *Fehlerruckgabe*/ 
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SHOWDIRO SHOWDIR(Verzeichnis[, ALL' I TILE' I DIR'][,Fullz.]) 

Gibt den Inhalt des angegebenen Verzeichnisses als eine Folge von 
jeweils durch Leerzeichen voneinander getrennten Namen zuriick. 
Der zweite Parameter ist ein Optionsschliisselwort, uber das 
gesteuert wird, ob alle Eintrage (ALL), nur Dateien (FILE) oder nur 
Unterverzeichnisse (DIR) des betreffenden Verzeichnisses beriick- 
sichtigt werden sollen. Beispiel: 

SAY SHOWDIR ( ' SYS : REXXC ' , ' f , ' ; ' ) 

-^ WaitFbrPort ;TS;TE;TCO;RXSET;RXLIB;RXC;RX;HI 



SHOWLISTO SHOWLISTG'A* I D' I H' I T I X' I 'M' I 

P' I 'R' I 'S r I T IV I 'W'^NameJLFullzeichen]) 

Eine Liste wird durch Angabe ihres Anfangsbuchstabens ausge- 
wahlt. Mogliche Argumente sind: 

A (ASSIGNS and Assigned Device) Zuordnungen und zugeordnete 

Gerate 

D (Device Drivers) Geratetreiber 

H (Handlers) EinVAusgabeprogramme 

I (Interrupts) Unterbrechungen 

L (Libraries) Bibliotheken 

M (Memory List Items) Eintrage der Speicherfiste 

P (Ports) 

R (Resources) Ressourcen Oder Betriebsmittel 

S (Semaphores) Semaphoren 

T (Tasks (Ready)) Bereite Tasks 

V (Volume Names) Datentragernamen 

W (Waiting Tasks) Anstehende Tasks 

Wird nur ein Argument angegeben, gibt SHOWLISTO eine 
Zeichenfolge mit Leerzeichen als Trennzeichen zurtick. Wird ein 
Fiillzeichen angegeben, wird dieses anstelle von Leerzeichen als 
Trennzeichen verwendet. Wird das Argument "Name" angegeben, 
gibt SHOWLISTO einen booleschen Wert zuriick, der angibt, ob die 
angegebene Liste diesen Namen enthalt. Beachten Sie bitte, daB bei 
Namen zwischen Grofi- und Kleinschreibung unterschieden wird. 
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Wahrend des Durchsuchens der Liste werden Task-Wechsel unter- 
bunden, um eine exakte Moment aufnahme der aktuellen Liste zu 
erhalten. 

SAY SHOWI,IST( ' P' ) -^ REXX MyCon 

SAY SHOWLIST (' P ',,';' ) -» REXX;MyCon 

SAY SHOWLIST ( ' P ' , ' REXX ' ) -» 1 



STATEFO STATEF(Dateiname) 

Gibt eine Zeichenfolge mit Inform ationen liber eine externe Datei 
zuriick. Die Zeichenfolge hat folgendes Format: 

"{DIR I FILE} Lange Blocke Schut:- 7 . Tage Minuten Ticks 

Kommentar . " 

"Lange" bezeichnet die Lange der Datei in Bytes, "Block" die Lange 
der Datei in Blocken. Beispiel: 

SAY STATEF ( " LIBS : REXXSupport . library" ) 

/*mogliches Ergebnis "FILE 2524 5 RW-D 4866 817 

2088*/ 



WAITPKTO WAITPKT( Name) 

Wartet an dem mit "Name" bezeichneten Message-Port auf den 
Empfang einer Nachricht. Dieser Port muB zuvor innerhalb des 
aktuellen ARexx-Programms durch den Aufruf der Funktion 
OPENPORTO geoffnet worden sein. Der boolesche Riickgabewert 
besagt, ob ein Nachrichtenpaket am Port vorliegt. Normalerweise 
ist der Riickgabewert 1 (Wahr), da die Funktion so lange wartet, bis 
sich am betreffenden Message-Port etwas tut. 

Das Paket muB anschlieBend mit einem Aufruf der Funktion 
GETPKTO eingelesen und dann mit der Funktion REPLYQ wieder 
zuriickgeschickt werden. Alle eingegangenen, aber noch nicht 
zuriickgeschickten Nachrichtenpakete werden beim Verlassen des 
ARexx-Programms automatisch mit dem Riickgabewert 10 beant- 
wortet (Funktion REPLY). Beispiel: 

CALL WAITPKT 'MeinPort' /*Solange warten*/ 



Kapitel6 

Fehlersuche 



ARexx bietet Funktionen zur Fehlersuche (engl. debugging) und 
Ablaufverfolgung (engl. tracing) auf Quelltextebene. Die Ablaufver- 
folgung zeigt wahrend der Ausfuhrung eines Programms ausge- 
wahlte Anweisungen innerhalb dieses Programms an. Trifft der 
AblaufverfolgungsprozeB auf eine Klausel, werden ihre Zeilen- 
numraer, ihr Quelltext und die Klausel betreffende Informationen 
an der Konsole angezeigt. 

Das interne Interrupt-System gibt dem ARexx-Programm die 
Moglichkeit, bestimmte synchrone oder asynchrone Ereignisse zu 
erkennen und entsprechend auf solche Ereignisse zu reagieren. 
Ereignisse wie Syntaxfehler oder externe Unterbrechungsanforde- 
rungen, die normalerweise zum Verlassen des Programms fuhren 
wiirden, konnen auf diese Weise abgefangen und durch geeignete 
MaBnahmen korrigiert werden. 



6. 1 Ablaufverfolgung 

Die Ablaufverfolgungsoption bestimmt, welche Klauseln des Quell- 
texts verfolgt werden sollen. Sie besitzt zwei Modifizierungskenn- 
zeichen zur Steuerung der Kommandosperre und der Ablaufver- 
folgung im Dialogbetrieb (interaktiv). Ablaufverfolgungsoptionen 
konnen auf einen einzigen Buchstaben abgekiirzt angegeben 
werden. Mogliche Optionen sind: 
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ALL 
BACKGROUND 

COMMANDS 

ERRORS 
INTERMEDIATES 



LABELS 



NORMAL 
(Standardwert) 



OFF 
RESULTS 



SCAN 



Alle Klauseln fallen unter die Ablaufverfolgung. 

Es findet keine Ablaufverfolgung statt, und das 
Programm kann nicht zu einer interaktiven 
Ablaufverfolgung veranlaBt werden. 

Alle Kommandoklauseln fallen unter die 
Ablaufverfolgung, bevor sie an den externen Host 
gesendet werden. Von Null abweichende 
Ruckgabewerte werden an der Konsole angezeigt. 

Kommandos, die einen von Null abweichenden 
Ruckgabewert generieren, werden nach Ausfuhrung 
der Klausel verfolgt. 

Alle Klauseln fallen unter die Ablaufverfolgung. 
Wahrend der Auswertung der Ausdrucke werden 
Zwischenergebnisse angezeigt. Zu diesen 
Ergebnisssen gehoren die aus Variablen 
abgerufenen Werte, erweiterte zusammenge-setzte 
Namen und die Ergebnisse von Funktionsaufrufen. 

Alle Sprungmarkenklauseln werden wahrend ihrer 
Ausfuhrung verfolgt. Eine Sprungmarke wird immer 
dann angezeigt, wenn die Steuerung an eine 
andere Stelle ubertragen wird. 

Kommandoklauseln, deren Ruckgabewerte die 
aktuellen Fehlergrenzwerte uberschreiten, werden 
nach ihrer Ausfuhrung in die Ablaufverfolgungs-liste 
aufgenommen, und eine Fehlermeldung wird 
angezeigt. 

Die Ablaufverfolgung ist ausgeschaltet. 

Alle Klauseln werden vor ihrer Ausfuhrung in die 
Ablaufverfolgungsliste geschrieben, und die 
Ergebnisse jedes einzelnen Ausdrucks werden 
angezeigt. Werte, die Variablen durch einen der 
Befehle ARG, PARSE oder PULL zugeordnet 
werden, werden ebenfalls angezeigt. Diese Option 
empfiehlt sich, wenn Sie Programme einem 
allgemeinen Test unterziehen wollen. 

Dies ist eine spezielle Option, die alle Klauseln in 
die Ablaufverfolgungsliste schreibt und auf Fehler 
untersucht, aber die Ausfuhrung der Anweisungen 
verhindert. Sie eignet sich besonders zur erst- 
maligen Kontrolle neu geschriebener Programme. 
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Der Ablaufverfolgungsmodus kann iiber den Befehl TRACE oder die 
integrierte Funktion TRACEO gesetzt werden. Die Ablauf- 
verfolgung kann innerhalb eines Programms selektiv inaktiviert 
werden, um bereits getestete Komponenten von Programmen zu 
iiberspringen. 

Jede auf der Konsole angezeigte Zeile der Ablaufverfolgung ist 
eingeriickt, um die tatsachliche Steuerungs- bzw. Verschachtelungs- 
ebene der jeweiligen Klausel zu verdeutlichen. Ferner ist jede Zeile 
durch einen speziellen, dreistelligen Code gekennzeichnet (siehe 
dazu die folgende Tabelle 6-1). Dem Quelltext jeder Klausel wird die 
Zeilennummer innerhalb des Programms vorangestellt. Resultate 
und Zwischenresultate von Ausdnicken stehen in doppelten 
Anfuhrungszeichen, so daB auch voran- und nachgestellte Leer- 
zeichen sichtbar werden. 

Tabelle 6-1. Spezielle dreistellige Codes 

Code Angezeigte Werte 

+++ Kommando- oder Syntaxfehler 

>C> Erweiterter zusammengesetzter Name 

>F> Ergebnis eines Funktionsaufrufs 

>L> Sprungmarkenklausel 

>0> Ergebnis einer dyadischen Operation 

>P> Ergebnis einer Prafixoperation 

>U> Nicht initialisierte Variable 

>V> Wert einer Variablen 

>» Ergebnis eines Ausdrucks oder einer Schablone 

>.> Wert eines "Platzhalter" -Tokens 

6.1-1 Ausgabedaten der Ablaufverfolgung 

Die Ausgabedaten der Ablaufverfolgung eines Programms werden 
stets in einen von zwei logischen Datenstromen eingespeist. Der 
Interpreter sucht zunachst nach einem Datenstrom mit dem Namen 
STDERR und leitet die Ausgabe dorthin, falls dieser Datenstrom 
existiert. Andernfalls geht die Ausgabe an den siandardmaBigen 
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Ausgabedatenstrom STDOUT und wird mit der normalen 
Konsolenausgabe des Programms vermischt. Die Datenstrome 
STDERR und STDOUT konnen vom Programm aus geoffnet und 
geschlossen werden, so dafi der Programmierer das Ziel der 
Ablaufverfolgungsausgabe stets unter Kontrolle hat. 

In manchen Fallen ist der Ausgabedatenstrom eines Programms 
nicht vorab definiert. Wird z. B. ein Programm von einer Host- 
Anwendung aufgerufen, die keine Ein- und Ausgabedatenstrome 
bereitstellt, verfugt das Programm liber keine Ausgabekonsole. Um 
auch fur solche Programme eine Mbglichkeit der Ablaufverfolgung 
zu schaffen, kann der residente ProzeB eine spezielle, globale 
Ablaufverfolgungskonsole offnen, die von jedem aktiven Programm 
geoffnet werden kann. Wird diese Konsole geoffnet, offnet der 
Interpreter automatisch einen Datenstrom mit dem Namen 
STDERR fur jedes ARexx-Programm, in dem STDERR zur Zeit 
nicht definiert ist. Das Programm leitet dann seine Ablauf- 
verfolgungsausgabe an diesen neuen Datenstrom um. 

Mit dem Kommandohilfsprogramm TCO (TraCe Open) kann eine 
Konsole fur globale Ablaufverfolgung geoffnet werden. ARexx- 
Programme leiten die Ausgabedaten ihrer Ablaufverfolgung auto- 
matisch in das neue Fenster um, das als standardmaBige 
AmigaDOS-Konsole geoffnet wird. Der Benutzer kann Position und 
GroBe dieses Fensters beliebig verandern. 

Die Ablaufverfolgungskonsole dient auch als Eingabedatenstrom fur 
Programme wahrend der interaktiven Ablaufverfolgung. Wenn ein 
Programm auf Eingabedaten zur Ablaufverfolgung wartet, miissen 
diese Daten uber die Ablaufverfolgungskonsole (in deren Fenster) 
eingegeben werden. Beliebig viele laufende Programme konnen sich 
die Ablaufverfolgungskonsole teilen. Es empfiehlt sich allerdings, 
die Ablaufverfolgung immer nur fur jeweils ein Programm zu 
aktivieren. 

Die globale Konsole kann mit dem Kommando TCC (TraCe Close) 
geschlossen werden. Das SchlieBen wird allerdings erst ausgefuhrt, 
wenn alle Leseanforderungen an die Konsole bearbeitet wurden. 
Die Konsole wird also erst geschlossen, wenn alle aktiven 
Programme melden, daB sie die Konsole nicht mehr benutzen. 
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6. 1.2 Kommandosperre 

ARexx verfugt liber einen Ablaufverfolgungsmodus, der Host- 
Kommandos unterdriickt, die sog. Kommandosperre. In diesem 
Modus werden Kommandoklauseln in der iiblichen Weise 
ausgewertet, das Kommando wird jedoch nicht wirklich an den 
externen Host gesendet. Der Riickgabewert (RC) wird auf Null 
gesetzt. Auf diese Weise konnen Programme gestestet werden, die 
Kommandos mit einer potentiell zerstorenden Wirkung ausgeben, 
z. B. das Loschen von Dateien oder das Formatieren von Festplatten 
oder Disketten. Die Kommandosperre gilt jedoch nicht fur 
Kommandoklauseln, die im Dialogbetrieb (interaktiv) eingegeben 
werden. Solche Kommandos werden stets ausgefuhrt, der Wert der 
Sondervariablen RC bleibt allerdings unverandert. 

Die Kommandosperre kann in Verbindung mit jeder 
Ablaufverfolgungsoption eingesetzt werden. Sie wird durch das 
Zeichen "!" gesteuert, das allein stehen oder einer der alpha- 
betischen Optionen in einem TRACE-Befehl vorangestellt werden 
kann. Mit jedem vorkommenden "!" wird vom zur Zeit aktiven 
Sperrmodus in den anderen Modus umgeschaltet. Die Kommando- 
sperre wird aufgehoben, wenn die Ablaufverfolgung auf OFF 
gesetzt wird. 



6. 1.3 Interaktive Ablaufverfolgung 

Die interaktive Ablaufverfolgung ist eine Fehlersuchhilfe, die es 
dem Benutzer ermoglicht, wahrend der Ausfiihrung eines Pro- 
gramms Quellanweisungen einzugeben. Uber solche Anweisungen 
konnen Variablenwerte iiberpruft oder verandert, Kommandos 
ausgegeben oder auf andere Weise mit dem Programm in einen 
Dialog getreten werden. Jede gtiltige Sprachanweisung kann 
interaktiv eingegeben werden. Es gelten die gleichen Regeln und 
Einschrankungen wie fur den Befehl INTERPRET. Insbesondere ist 
darauf zu achten, daB zusammengesetzte Anweisungen, wie z. B. 
DO und SELECT, innerhalb der eingegebenen Zeile vollstandig 
sind. 

Die interaktive Ablaufverfolgung kann mit jeder Ablaufverfolgungs- 
option verwendet werden. Im Dialogmodus legt der Interpreter 
nach jeder in die Ablaufverfolgungsliste geschriebenen Klausel eine 
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Pause ein und fordert mit dem Code "+++" zu einer Benutzereingabe 
auf. Bei jeder dieser Pausen hat der Benutzer drei verschiedene 
Antworten zur Auswahl: 

• Eingabe einer Nullzeile (einfach Eingabetaste) - das Programm 
wird bis zum nachsten Pausenpunkt fortgesetzt. 

• Eingabe eines Gleichheitszeichens (=) - die vorherige Klausel 
wird nochmals ausgefuhrt. 

• Jede andere Eingabe wird als Fehlersuchanweisung behandelt; 
sie wird gepnift und ausgefuhrt. 

Da der Interpreter nach erfolgter Ablaufverfolgung einer Klausel 
pausiert, werden die Pausenpunkte von der zur Zeit aktivierten 
Ablaufverfolgungsoption bestimmt. Die Ausfuhrung mancher Be- 
fehle kann allerdings nicht ohne Risiko wiederholt werden, so daB 
der Interpreter nach Ausfuhrung solcher Befehle nicht pausiert. 
Diese Befehle sind CALL, DO, ELSE, IF, THEN und OTHERWISE. 
Der Interpreter pausiert gleichfalls nicht nach Klauseln, die einen 
Ausfuhrungsfehler generiert haben. 

Die interaktive Ablaufverfolgung wird durch das Zeichen "?" 
gesteuert, das allein stehen oder mit einer der alphabetischen 
Optionen in einem TRACE-Befehl angegeben werden kann. Einer 
Option konnen beliebig viele "?" vorangestellt werden. Mit jedem 
vorkommenden "?" wird vom zur Zeit aktiven Modus in den anderen 
Modus umgeschaltet. Ware z. B. die aktuelle Ablaufverfolgungs- 
option NORMAL, so wiirde mit "TRACE ?R" die Option RESULTS 
gesetzt und der interaktive Ablaufverfolgungsmodus aktiviert. Ein 
spateres "TRACE ?" wiirde die interaktive Ablaufverfolgung wieder 
ausschalten. 



6. 1.3. 1 Fehlerbehandlung 

Der ARexx-Interpreter stellt wahrend der Fehlersuche eine 
spezielle Fehlerbehandlung zur Verfugung. Wahrend der inter- 
aktiven Fehlersuche gefundene Fehler werden gemeldet, fuhren 
aber nicht zur Beendigung des Programmlaufs. Diese spezielle Ver- 
arbeitung gilt allerdings nur fur im Dialogbetrieb eingegebene 
Anweisungen. 

ARexx inaktiviert auch die internen Interrupt-Kennzeichen 
wahrend der interaktiven Fehlersuche. Damit wird eine unbeab- 
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sichtigte Steuerungsiibertragung verhindert, die durch einen Fehler 
oder das Antreffen einer nicht initialisierten Variable ausgelost 
werden konnte. Wird jedoch der Befehl "SIGNAL Sprungmarke" 
eingegeben, findet der Steuerungstransfer statt, und eventuell ver- 
bleibende interaktive Eingabedaten bleiben unberiicksichtigt. Der 
Befehl SIGNAL kann auch weiterhin dazu verwendet werden, die 
Interrupt-Kennzeichen zu andern. Die neuen Einstellungen treten 
in Kraft, wenn der Interpreter in den normalen Verarbeitungs- 
modus zuriickkehrt. 

Jeder ARexx-Task initialisiert seinen Fehlergrenzwert ent- 
sprechend dem Grenzwert des Klienten (normalerweise 10). Damit 
wird das Ausdrucken unnotiger Kommandofehler unterbunden. Der 
Fehlergrenzwert kann mit OPTIONS FAILAT verandert werden. 
Kommandofehler (RC > 0) und fehlgeschlagene Kommandos (RC >= 
FAILAT) konnen mit SIGNAL ON ERROR und SIGNAL ON 
FAILURE separat verfolgt werden. 

6. 1.3.2 Externes Ablaufverfolgungskennzeichen 

ARexx verfugt iiber ein externes Ablaufverfolgungskennzeichen, 
mit dem Programme in den interaktiven Ablaufverfolgungsmodus 
gezwungen werden konnen. Wenn dieses Kennzeichen gesetzt wird 
(mit dem Kommandohilfsprogramm TS (Trace Set)), geht jedes Pro- 
gramm in den interaktiven Ablaufverfolgungsmodus iiber (sofern es 
sich nicht bereits in diesem Modus befindet). Die interne Ablauf- 
verfolgungsoption wird auf RESULTS gesetzt, es sei denn, sie ist 
gegenwartig auf INTERMEDIATES oder SCAN gesetzt. In diesen 
Fallen bleibt sie unverandert. Programme, die aufgerufen werden, 
wahrend das externe Ablaufverfolgungskennzeichen gesetzt ist, 
beginnen die Ausfuhrung im interaktiven Ablaufverfolgungsmodus. 

Das externe Ablaufverfolgungskennzeichen bietet eine Moglichkeit, 
die Kontrolle iiber Programme wieder zu gewinnen, die sich in 
Schleifen befinden oder nicht reagieren. Sobald ein Programm in 
den interaktiven Ablaufverfolgungsmodus iibergeht, kann der 
Benutzer die Programmanweisungen Schritt fur Schritt durchgehen 
und das Problem diagnostizieren. Die externe Ablaufverfolgung ist 
ein globales Kennzeichen, d. h. sie wirkt sich auf alle gegenwartig 
aktiven Prozesse aus. Das Ablaufverfolgungskennzeichen bleibt 
solange gesetzt, bis es mit dem Kommandohilfsprogramm TE (Trace 
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End) geloscht wird. Jedes Programm verwaltet eine interne Kopie 
des letzten Status des Ablaufverfolgungskennzeichens und setzt 
seine eigene Ablaufverfolgungsoption auf OFF, wenn es feststellt, 
dafi das Ablaufverfolgungskennzeichen geloscht wurde. Programme 
im Ablaufverfolgungsmodus BACKGROUND reagieren nicht auf 
das externe Ablaufverfolgungskennzeichen, 
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ARexx unterhalt ein internes Interrupt-System zum Erkennen und 
Abfangen bestimmter Fehlerbedingungen. Wird ein Interrupt 
aktiviert und seine entsprechende Bedingung tritt ein, kommt es 
zur Ubertragung der Steuerung an die dieser Unterbrechung zuge- 
horige Sprungmarke. Auf diese Weise kann ein Programm die 
Steuerung behalten, obwohl die vorliegenden Bedingungen 
normalerweise zum Abbruch des Programms fuhren wiirden. Die 
Interrupt-Bedingungen kbnnen durch synchrone Ereignisse (z. B. 
Syntaxfehler) oder asynchrone Ereignisse z. B. Unterbrechungs- 
anforderungen iiber die Tastatureingabe Ctrl-C) ausgelost werden. 

Hinweis Solche internen Interrupts haben nichts mit dem 
Hardware-Interrupt-System zu tun, das vom 
Betriebssystem EXEC verwaltet wird. 

Der jedem Interrupt zugeordnete Name ist jeweils die 
Sprungmarke, an die die Steuerung iibergeben wird. Damit 
ubertragt ein Interrupt SYNTAX die Steuerung also an die 
Sprungmarke "SYNTAX:". Interrupts kbnnen mit dem Befehl 
SIGNAL aktiviert oder inaktiviert werden. Der Befehl "SIGNAL ON 
SYNTAX" aktiviert z. B. den Interrupt SYNTAX. 
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Die von ARexx unterstlitzten Interrupts sind: 

BREAK_C Fangt eine von AmigaDOS generierte Unterbrechvungs- 

anforderung Ctrl-C ab (d. h. sie'wird entdeckt und als Signal 
interpretiert, aber nicht als normale Eingabe). 1st der 
Interrupt nicht aktiviert, bricht das Programm sofort ab, gibt 
die Fehlermeldung "Execution halted" (Ausfuhrung 
abgebrochen) aus und gibt den Fehlercode 2 zuruck. 

BREAK_D Fangt eine von AmigaDOS generierte Unterbrechungs- 

anforderung Ctrl-D ab. 1st der Interrupt nicht aktiviert, wird 
die Unterbrechungsanforderung ignoriert. 

BREAK_E Fangt eine von AmigaDOS generierte 

Unterbrechungsanforderung Ctrl-E ab. 1st der Interrupt 
nicht aktiviert, wird die Unterbrechungsanforderung 

ignoriert. 

BREAK„F Fangt eine von AmigaDOS generierte 

Unterbrechungsanforderung Ctrl-F ab. 1st der Interrupt nicht 
aktiviert, wird die Unterbrechungsanforderung ignoriert. 

ERROR Dieser Interrupt wird von jedem Host-Kommando generiert, 

das einen von Null abweichenden Fehlercode zuruckgibt. 

HALT 1st dieser Interrupt aktiviert, wird eine externe 

Unterbrechungsanforderung abgefangen. Andernfalls bricht 
das Programm sofort ab und gibt die Fehlermeldung 
"Execution halted" (Ausfuhrung abgebrochen) aus. 

IOERR 1st dieser Interrupt aktiviert, werden vom E/A-System 

entdeckte Fehler abgefangen. 

NOVALUE 1st diese Bedingung aktiviert, kommt es zu einem Interrupt, 
wenn eine nicht initialisierte Variable verwendet wird. Die 
Auslosung dieses Interrupts kann innerhalb eines 
Ausdrucks, im Befehl UPPER oder in der integrierten 
Funktion VALUE() erfolgt sein. 

SYNTAX Dieser Interrupt generiert einen Syntax- oder 

Ausfuhrungsfehler. Nicht alle Fehler dieser Art konnen 
abgefangen werden. Manche Fehler treten vor der 
Ausfuhrung eines Programms auf. Diejenigen, die von der 
externen ARexx-Schnittstelle entdeckt werden, konnen vom 
Interrupt SYNTAX nicht abgefangen werden. 
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Wenn ein Interrupt zwangslaufig einen Steuerungstransfer 
("Sprung") herbeifuhrt, werden alle zur Zeit aktiven Steuerungs- 
bereiche inaktiviert. Der Interrupt, der die Steuerungsiibertragung 
ausloste, wird inaktivert. Dies verhindert die Entstehung einer 
rekursiven Interrupt-Schleife. BetrofFen sind allerdings nur die 
Steuerungsstrukturen der aktuellen Umgebung. Ein innerhalb 
einer Funktion generierter Interrupt hat also keine Auswirkungen 
auf die Umgebung der Aufrufebene. 

Das Auftreten eines Interrupts wirkt sich auf zwei Sondervariablen 
aus: 

SIGL 1st stets auf die aktuelle Zeilennummer gesetzt, bevor es zum 

Steuerungstransfer kommt. Damit kann festgestellt werden, 
welche Zeile des Quelltextes ausgefuhrt wurde. 

RC 1st auf den Fehlercode gesetzt, der die Bedingung ausloste. 

Bei ERROR-lnterrupts ist dieser Wert der Ruckgabewert eines 
Kommandos und kann normaierweise als Einstufung des 
Fehlerschweregrades interpretiert werden. Der Wert des 
SYNTAX-lnterrupts ist stets ein ARexx-Fehlercode. 

Interrupts sind sehr niitzlich bei der Fehlerbehebung. Dazu gehort 
die Information externer Programme iiber das Auftreten eines 
Fehlers oder das Melden weiterer Diagnosedaten zur Eingrenzung 
des Problems. Beispielprogramm 15 zeigt, wie bei Feststellung eines 
Syntaxfehlers ein Kommando "message" an den externen Host 
ausgegeben wird. 

Programm 15. Interruplrexx 

/*Ein Makro- Programm fur 'MeinEdit 1 */ 
SIGNAL ON SYNTAX /^Interrupt aktivieren* / 
(normale Verarbeitungsbef ehle) 
EXIT 

SYNTAX: /*Syntaxf ehler entdeckt*/ 

ADDRESS ' MeinEdit ' 

'message ' ' error ' RC err or text (RC) 
EXIT 10 



Kapitel 7 

Syntaxanalyse 



Bei der Syntaxanalyse (engL Parsing) werden Teilzeichenfolgen aus 
einer Zeichenfolge extrahiert und Variablen zugeordnet Die Syn- 
taxanalyse wird mit dem Befehl PARSE oder seinen Varianten ARG 
und PULL aufgerufen. Die Eingabe fur diese Operation heiflt 
Analysezeichenfolge und stammt aus verschiedenen Quellen, z. B. 
aus Argumentzeichenfolgen, Ausdriicken oder auch von der 
Konsole. 

Funktionen zur Manipulation von Zeichenfolgen, wie SUBSTRO 
und INDEXO, konnen zur Syntaxanalyse eingesetzt werden. Der 
Befehl PARSE ist allerdings weit effizienter, besonders wenn viele 
Felder aus einer Zeichenfolge extrahiert werden. 



7. 1 Schablonen 

Die Syntaxanalyse wird von einer Schablone gesteuert. Unter einer 
Schablone versteht man eine Token-Gruppe, in der die Variablen 
angegeben sind, die mit Werten ausgestattet werden sollen, und die 
Art und Weise, wie die Wertzeichenfolgen zu extrahieren sind. Die 
Anordnung der Tokens in der Schablone bestimmt, ob das Token 
eines der beiden Basisobjekte einer Schablone ist: eine Marke oder 
ein Ziel. 

Marke Legt die Start- und Endposition in der Analysezeichenfolge 

oder eine Suchposition test. 

Ziel Ein Symbol, dem durch die Syntaxanalyseoperation ein 

Wert zugeordnet wird. Dieser Wert ist die durch die 
Position der Marken definierte Teilzeichenfolge. 



7-2 Syntaxanalyse 

7.1.1 Marken 

Es gibt drei Arten von Markenobjekten: 

Absolute Marken Tatsachliche Indexposition in der Analysezeichen- 
folge. 

Relative Marken Position relativ zur aktuellen Position (positiver oder 
negativer Wert). 

Mustermarken Vergleicht das Suchmuster mit der Analysezeichen- 

folge, beginnend an der aktuellen Suchposition. 

7.1.2 Ziele 

Ziele konnen ebenso wie Marken auf die Suchposition EinfluB 
haben, wenn Wertzeichenfolgen durch "Tokenisierung", also die 
Zerlegung von Zeichenfolgen in Tokens, extrahiert werden. Syntax- 
analyse durch Tokenisierung extrahiert Wbrter (Tokens) aus der 
Analysezeichenfolge und wird immer dann verwendet, wenn auf ein 
Ziel unmittelbar ein weiteres Ziel folgt. Wahrend der Tokenisierung 
wandert die aktuelle Suchposition iiber eventuelle Leerzeichen 
hinweg zum Anfang des nachsten Wortes weiter. Der Endeindex ist 
die Position genau hinter dem Ende des Worts, so dafi die 
Wertzeichenfolge weder voran- noch nachgestellte Leerzeichen auf- 
weist. 

Ziele werden durch variable Symbole angegeben. Der Platzhalter 
Punkt (.) ist ein spezieller Zieltyp und verhalt sich genau wie ein 
normales Ziel, mit der Ausnahme, dafi er nicht liber einen zuge- 
ordneten Wert verfugt. 
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7. 1.2.1 Schablonenobjekte 

Jedes Objekt in einer Schablone wird durch ein oder mehrere 
Tokens angegeben: 

Symbole Ein Symbol kann ein Ziel oder eine Marke angeben. Um eine 

Marke handelt es sich, wenn es auf einen Operator (+, - oder 
=) folgt und der Symbolwert als absolute oder relative 
Position verwendet wird. Symbole in runden Klammern sind 
dagegen Mustermarken, und der Symbolwert dient als 
Musterzeichen-folge. Symbole sind Ziele, wenn keinerder 
beschriebenen Falle zutrifft und das Symbol eine Variable ist. 
Feste Symbole bezeichnen stets absolute Marken und 
mussen ganze Zahlen sein. Einzige Ausnahme bildet der 
Platzhalter (.) als Zielan-gabe. 

Eine Zeichenfolge steilt immer eine Mustermarke dar. 



Zeichen- 
folgen 
Runde 
Klammern 



Operatoren 



Kommas 



Ein in runden Klammern stehendes Symbol ist eine 
Mustermarke. Der Wert des Symbols dient als Muster- 
zeichenfolge. Das Symbol kann test oder variabel sein, in der 
Regel ist es aber eine Variable, da ein testes Muster 
einfacher als Zeichenfolge angegeben werden konnte. 

Die drei Operatoren (+, - und =) sind innerhalb einer 
Schablone gultig und mussen einem festen oder variablen 
Symbol vorangestellt sein. Der Wert des Symbols wird als 
Marke verwendet und mu(3 ganzzahlig sein. Die Operatoren 
"+" und "-" bezeichnen eine relative Marke, wobei der 
Operator "-" einen negativen Wert definiert. Der Operator "=" 
bezeichnet eine absolute Marke und kann weggelassen 
werden, wenn die Marke durch ein testes Symbol definiert ist. 

Das Komma (,) markiert das Ende einer Schablone. Es dient 
auch als Trennzeichen, wenn innerhalb eines Befehls 
mehrere Schablonen angegeben werden. Vor der Verarbei- 
tung aufeinanderfolgender Schablonen erhalt der Interpreter 
jeweils eine neue Analysezeichenfolge. Bei einigen Quellpro- 
grammoptionen ist die neue Zeichenfolge mit der vorherigen 
identisch. Die Optionen ARG, EXTERNAL und PULL liefern in 
der Regel eine von der vorherigen abweichende 
Zeichenfolge, ebenso wie die Option VAR, wenn die Variable 
verandert wurde. 



7-4 Syntaxanalyse 

Das Kommandoanalyseprogramm der ARexx-Schnittstelle wurde 
dahingehend vereinheitlicht, daB Sequenzen mit doppelten Begren- 
zungszeichen innerhalb einer (in Anfuhrungszeichen stehenden) 
Zeichenfolgendatei erkannt werden. Die Konvention fur die Ver- 
wendung von Anfuhrungszeichen ist besonders geeignet fur 
kleinere Programme. In komplexeren Programmen kann es relativ 
leicht vorkommen, daB die Verschachtelungsebenen fur das Setzen 
von Anfuhrungszeichen nicht mehr ausreichen. Einzelne und 
doppelte Anfuhrungszeichen sind innerhalb eines REXX-Progamms 
Equivalent, allerdings trifft die externe Umgebung moglicherweise 
eine Unterscheidung zwischen den verschiedenen Anfuhrungs- 
zeichen. 

AmigaDOS verwendet das doppelte Anfuhrungszeichen. Zeichen- 
folgen, die von einer Shell aus eingegeben werden, mussen mit 
einem doppelten Anfuhrungszeichen beginnen, besonders, wenn sie 
Semikolons enthalten sollen. Beispiel: 

RX "SAY 'Das is' ' ja ' 'n Ding - ich glaub' * , mich 
tritt ' 'n Pferd! ' " 

— > Das is' ja 'n Ding - ich glaub', mich tritt 'n 
Pferd! 

RX "SAY Hallo!". -> "Hallo!" 



7.2 Such y or gang 



Suchpositionen werden in Form eines Index innerhalb der 
Analysezeichenfolge angegeben und liegen im Bereich von 1 
(Anfang der Zeichenfolge) bis zur Lange der Zeichenfolge plus 1 
(hinter dem Ende der Zeichenfolge). 

Die in Form von zwei Suchindizes angegebene Teilzeichenfolge 
enthalt die Zeichen von der Startposition bis eine Stelle vor der 
Endposition (die Endposition selbst gehort also nicht mehr dazu!). 
Die Indizes 1 und 10 schliefien also nur die Positionen 1 bis 9 der 
Analysezeichenfolge ein. 1st der Wert des zweiten Suchindex kleiner 
oder gleich dem ersten, wird der Rest (beginnend mit der Start- 
position) der Analysezeichenfolge als Teilzeichenfolge verwendet. 
Die Schablonenangabe: 

PARSE ARG 1 alle 1 erst zweit 
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ordnet also die gesamte Analysezeichenfolge der Variablen ALLE 
zu. Befindet sich der aktuelle Suchindex bereits am Ende der 
Analysezeichenfolge, verbleibt als Rest eine leere Zeichenfolge. 

Wenn eine Mustermarke mit der Analysezeichenfolge abgeglichen 
wird, ist die Markenposition der Index des ersten Zeichens des 
gefundenen Musters oder aber das Ende der Zeichenfolge, wenn 
keine Entsprechung gefunden wurde. Immer wenn eine Ent- 
sprechung gefunden wird, wird das Muster aus der Zeichenfolge 
geloscht. Dies ist der einzige Fall, bei dem die Analysezeichenfolge 
im Verlauf der Syntaxanalyse verandert wird. 

Schablonen werden von links nach rechts abgesucht, wobei der 
Anfangs-Suchindex auf 1 gesetzt ist. Jedesmal, wenn ein Marken- 
objekt angetroffen wird, wird die Suchposition entsprechend dem 
Typ und dem Wert der Marke aktualisiert. Wird ein Zielobjekt 
gefunden, so wird der zugeordnete Wert durch Pruning des 
nachsten Schablonenobjekts festgelegt. Ist das nachste Objekt ein 
weiteres Ziel, so wird die Wertzeichenfolge durch Tokenisierung der 
Analysezeichenfolge bestimmt. Andernfalls dient die aktuelle Such- 
position als Anfang der Wertzeichenfolge und die durch die 
darauffolgende Marke defmierte Position als Ende der Wert- 
zeichenfolge. 

Der Suchvorgang wird fortgesetzt, bis alle Objekte der Schablone 
verwendet worden sind. Jedem Ziel wird ein Wert zugeordnet. 
Wenn die Analysezeichenfolge vollstandig ausgeschopft wurde, wird 
jedem danach folgenden Ziel die Nullzeichenfolge zugeordnet. 



7.3 Beispiele zur Syntaxanalyse 



7.3. 1 Syntaxanalyse durch Tokenisierung 

Computerprogramme zerlegen eine Zeichenfolge haufig in ihre 
Bestandteile - Wbrter oder Tokens. Dies erreicht man mittels einer 
Schablone, die sich vollstandig aus Variablen (Zielen) zusam- 
mensetzt. 
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/*Angenommen es wurde "Hammer 1 Stuck DM6 00.0 0" 

eingegeben*/ 

PULL teil anz einh preis . 

In diesem Beispiel wird die Eingabezeile aus dem Befehl PULL in 
Worter zerlegt und den Variablen in der Schablone zugewiesen. Die 
Variable "teil" erhalt den Wert "Hammer", anz wird auf "1" gesetzt, 
einh auf "Stuck", und preis erhalt den Wert "DM600.00". Der 
abschlieBende Platzhalter (.) erhalt einen Nullwert, da die Eingabe 
nur aus vier Wortern besteht. Allerdings fuhrt er dazu, daB die 
vorherige Variable (preis) einen tokenisierten Wert erhalt. Wurde 
der Platzhalter weggelassen, so wurde der gesamte Rest der 
Analysezeichenfolge der Variable "preis" zugewiesen, so daB dieser 
ein Leerzeichen vorangestellt wurde. 

antwort = "Nur Amiga macht es moglich." 
DO forever 

PARSE VAR antwort erst antwort 
/*Erstes Wort in 'erst' und den Rest in 'antwort' 
stellen. */ 

IF erst ==' ' THEN LEAVE 

/*Beenden, wenn keine weiteren Worter mehr 
vorhanden sind*/ 

SAY antwort 

END 

Das erste Wort einer Zeichenfolge wird entfernt und der Rest 
wieder in die Zeichenfolge gestellt. Der ProzeB wird so oft wieder- 
holt, bis keine Worter mehr extrahiert werden konnen. Daraus 
ergibt sich folgende Ausgabe: 

Amiga macht es moglich. 
macht es moglich. 
es moglich. 
moglich. 

7.3.2 Syntaxanalyse nach Mustern 

Mustermarken extrahieren die gewiinschten Felder. Das "Muster" 
ist in diesem Fall sehr einfach — es besteht nur aus einem einzigen 
Zeichen. Es konnte aber auch eine beliebig lange Zeichenfolge 
gewahlt werden. Diese Form der Syntaxanalyse empfiehlt sich 
besonders, wenn in der Analysezeichenfolge Begrenzungszeichen 
vorkommen. 



Syntaxanalyse ~_" 7-7 



/*Angenommen, die Argument zeichenf olge lautet 

"12,35.5, 1" */ 

ARG hours ' , ' rate ' , ' withhold 

Das Muster wird aus der Analysezeichenfolge entfernt, wenn eine 
Ubereinstimmung festgestellt wird. Wird die Analysezeichenfolge 
erneut von Anfang an abgesucht, kann die Zeichenfolge eine andere 
Lange und Struktur aufweisen als zu Beginn des Syntaxanalyse - 
prozesses. Die urspriingliche Quelle der Zeichenfolge wird jedoch 
niemals verandert. 



7.3.3 Syntaxanalyse nach Positionsmarken 

Die Syntaxanalyse mit Positionsmarken wird immer dann einge- 
setzt, wenn bekannt ist, dafl sich die Felder von Interesse an 
bestimmten Positionen innerhalb einer Zeichenfolge befinden. 



name 



Der zu verarbeitende Satz enthalt ein variables Langenfeld. Start- 
position und Lange des Felds werden im ersten Teil des Satzes mit 
einer variablen Positionsmarke angegeben, aufgrund der das 
gewiinschte Feld extrahiert wird. 

Die Sequenz "=start" ist eine absolute Marke, deren Wert aus der 
Position hervorgeht, die weiter vorne im Suchvorgang in die Start- 
variable gestellt wurde. Die Sequenz "+lang" liefert die tatsachliche 
Lange des Felds. 

7.3.4 Mehrere Schablonen 

Zu einem Befehl konnen Sie auch mehrere Schablonen angeben. 
Dazu sind die einzelnen Schablonen jeweils durch ein Komma 
voneinander zu trennen. Der Befehl ARG (oder PARSE UPPER 
ARG) greift auf die Argumentzeichenfolgen zu, die beim Aufruf des 
Programms zur Verfugung gestellt wurden. Die Schablonen greifen 
nacheinander auf je eine Argumentzeichenfolge zu. Zum Beispiel: 



/* Satze sehen wie folgt aus: 


*/ 


/* Start: 1-5 */ 




/* Lange: 6-10 */ 




/* Name: fangt an bei (Start) 


hat (Lang) */ 


PARSE value satz with 1 start 


+5 lang +5 =start 


+ lang 
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/*Angenommen, die Argumente lauten ( ' eins 

zwei , 12 , sort) */ 

ARG erstes zweites,menge, aktion, option 

Die erste Schablone besteht aus den Variablen erstes und zweites, 
die auf die Werte "eins" und "zwei" gesetzt werden. Die nachste 
Schablone weist den Wert "12" an "menge" zu, und "aktion" wird auf 
"SORT" gesetzt. Die letzte Schablone besteht aus der Variablen 
"option", die hier auf die leere Zeichenfolge gesetzt wird, da nur vier 
Argumente vorhanden waren. 

Wenn mehrere Schablonen mit den Quellenoptionen EXTERNAL 
oder PULL verwendet werden, fordert jede weitere Schablone vom 
Benutzer eine weitere Eingabezeile an: 

/*Lesen von nachname, vorname und weitere sowie von 

datum*/ 

PULL nachname ',' vorname weitere, datum 

Es werden zwei Eingabezeilen gelesen. Die erste Eingabezeile sollte 
drei Worter enthalten, die den Variablen "nachname", "vorname" 
und "weitere" zugewiesen werden. Auf die erste Variable folgt ein 
Komma. Die gesamte zweite Eingabezeile wird der Variablen 
"datum" zugewiesen. 

Mehrere Schablonen konnen auch mit einer Quellprogrammoption 
sinnvoll eingesetzt werden, die identische Zeichenfolgen zuriickgibt. 
Enthielt die erste Schablone Mustermarken, die die Analyse- 
zeichenfolge veranderten, konnen die folgenden Schablonen noch 
immer auf die Originalzeichenfolge zugreifen. Spater folgende 
Analysezeichenfolgen, die aus der Quelle VALUE hervorgehen, 
fiihren nicht dazu, daJ3 der Ausdruck neu ausgewertet wird, 
sondern lediglich die jeweils vorherigen Resultate abgerufen 
werden. 



Anhang A 

Fehlermeldungen 



Wenn der ARexx-Interpreter einen Fehler feststellt, gibt er einen 
Fehlercode zurlick, der Aufschlufl darliber gibt, um welche Art von 
Fehler es sich handelt. Normalerweise werden der Fehlercode, die 
Zeilennummer der Stelle im Quelltext, an der der Fehler auftrat, 
und eine kurze, den Fehler erlauternde Nachricht angezeigt. 
Anschlieflend wird die Verarbeitung des Programms abgebrochen 
und die Steuerung an die Aufrufebene zurlickgegeben, es sei denn, 
es war der SYNTAX-Interrupt (liber den Befehl SIGNAL) aktiviert. 
Die meisten Syntax- und Ausfuhrungsfehler lassen sich mit Hilfe 
des SYNTAX-Interrupts abfangen. Dies gibt dem Programmierer 
die Gelegenheit, die geeigneten Maflnahmen zur Fehlerbehebung zu 
ergreifen. Manche Fehler werden aber auch auBerhalb des Kon- 
texts eines ARexx-Programms verursacht und konnen demzufolge 
nicht mit diesem Verfahren abgefangen werden. Nahere Informa- 
tionen liber das Abfangen und Bearbeiten von Fehlern finden Sie in 
Kapitel 6. 

Jeder Fehlercode ist mit einem bestimmten Schweregrad ver- 
bunden, der dem aufrufenden Programm als primarer Ergebniscode 
gemeldet wird. Die Werte dieser Ergebniscodes sind 5 
(geringfugiger Fehler), 10 (weniger schwerer Fehler) und 20 (sehr 
schwerer Fehler). Der Fehlercode selbst bildet das Sekundar- 
ergebnis. Die Art der Weitermeldung solcher Codes hangt vom 
jeweiligen externen (aufrufenden) Programm ab. 

Auf den folgenden Seiten finden Sie eine Liste aller gegenwartig 
definierten Fehlercodes mit den entsprechenden Ergebniscodes und 
dem jeweiligen Text der Fehlermeldung. 
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Fehlermeldungen 



Tabelle A-1. Fehlercodes und Fehlermeldungen 


Fehler Fehler- 


Meldung 


Erlauterung 


code 






1 5 


Programm 


Das angegebene Programm 




nicht 


wurde nicht gefunden oder 




gefunden 


war kein ARexx-Programm. 




(Program 


Bei ARexx-Programmen wird 




not found) 


vor-ausgesetzt, da(3 sie mit 
einem Kommentar (/*...*/) 
beginnen. Dieser Fehler wird 
von der externen Schnittstelle 
festge-stellt und kann nicht mit 
dem SYNTAX-lnterrupt 
abgefangen werden. 


2 10 


Ausfuhrung 


Eine Unterbrechung durch 




gestoppt 


Ctrl-C Oder eine externe Hal- 




(Execution 


teanforderung wurde empfan- 




halted) 


gen, worauf die Verarbeitung 
des Programms abgebrochen 
wurde. Dieser Fehler wird ab- 
gefangen, wenn der HALT-ln- 
terrupt aktiviert ist. 


3 20 


Speicher- 


Der Interpreter konnte nicht 




platzmangel 


genugend Speicherplatz fur 




(Insufficient 


eine bestimmte Operation re- 




memory) 


servieren. Speicherplatz wird 



fur alle Analyse- und Aus- 
fuhrungsoperationen benotigt. 
Der Fehler kann daher nor- 
malerweise nicht mit dem 
SYNTAX-lnterrupt abgefangen 
werden. 



Fehlermeldungen 
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Fehler Fehler- 


Meldung 


Erlauterung 


code 






4 10 


Ungultiges 


Im Programm wurde ein Nicht- 




Zeichen 


ASCII-Zeichen (z. B. ein 




(Invalid 


Umlaut in einem Variablen- 




character) 


namen) entdeckt. 
Steuercodes und andere 
Nicht-ASCII-Zeichen konnen 
in einem Programm verwendet 
werden. Dazu mussen sie 
aber als Hexadezimal- oder 
Binar-zeichenfolgen definiert 
werden. Dies ist ein 
Suchphasenfehler und kann 
nicht mit dem SYNTAX- 
Interrupt abgefangen werden. 


5 10 


Ungerade 


Es fehlt ein abschlieBendes 




Anzahl von 


einfaches oder doppeltes 




Anfuhrungs- 


Anfuhrungszeichen. Uber- 




zeichen 


prufen Sie das Programm auf 




(Unmatched 


die korrekte Begrenzung alter 




quote) 


Zeichenfolgen. Dies ist ein 



10 



Suchphasenfehler und kann 
nicht mit dem SYNTAX- 
Interrupt abgefangen werden. 

Fehlendes Das AbschluGzeichen 7 eines 

Kommentar- Kommentars wurde nicht 
abschlufB- gefunden. Beachten Sie, daB 

zeichen Kommentare auch verschach- 

(Untermi- telt sein konnen. Zu jedem /* 

nated muf3 ein 7 vorhanden sein. 

comment) Dies ist ein Suchphasenfehler 

und kann nicht mit dem 
SYNTAX-lnterrupt abgefangen 
werden. 
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Fehler 


Fehler- 
code 


Meldung 


Erlauterung 


7 


10 


Klausel zu 


Eine Klausel war fur den 






lang 


internen Puffer zu lang. Die 






(Clause too 


Quelltextzeile sollte in kleinere 






long) 


Komponenten aufgeteilt 
werden. Dies ist ein Such- 
phasenfehler und kann nicht 
mit dem SYNTAX-lnterrupt 
abgefangen werden. 


8 


10 


Ungultiges 


Ein nicht erkanntes lexika- 






Token 


lisches Token wurde entdeckt, 






(Invalid 


oder eine Klausel konnte nicht 






token) 


korrekt klassifiziert werden. 



10 



10 



10 



Dies ist ein Suchphasenfehler 
und kann nicht mit dem 
SYNTAX-lnterrupt abgefangen 
werden. 



Symbol oder 


Es wurde versucht, eine 


Zeichenkette 


Zeichenkette zu erstellen, die 


zu lang 


die maximal zulassige Lange 


(Symbol or 


uberschritt. 


string too 




long) 




Ungultiges 


In einem Nachrichtenpaket, 


Nachrichten- 


das an den residenten ARexx- 


paket 


ProzeG gesendet wurde, 


(Invalid 


wurde ein ungultiger Aktions- 


message 


code entdeckt. Das Paket 


packet) 


wurde unverarbeitet zuruck- 




gegeben. Dieser Fehler wird 




von derexternen Schnittstelle 




festgestellt und kann nicht mit 




dem SYNTAX-lnterrupt abge- 




fangen werden. 



Fehlermeldungen 
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Fehler 


Fehler- 
code 


Meldung 


Erlauterung 


11 


10 


Fehler in der 


Eine Kommandozeichenfolge 






Kommando- 


konnte nicht verarbeitet 






zeichenfolge 


werden. Dieser Fehler wird 






(Command 


von der externen Schnittstelle 






string error) 


fest-gestellt und kann nicht mit 
dem SYNTAX-lnterrupt 
abgefangen werden. 


12 


10 


Fehlerruck- 


Eine externe Funktion gab 






gabe von 


einen von Null abweichenden 






der Funktion 


Fehlercode zuruck. Stellen Sie 






(Error return 


sicher, daB zu der Funktion 






from 


korrekte Argumente angege- 






function) 


ben wurden. 


13 


10 


Host- 


Der einer Host-AdreBzeichen- 






Umgebung 


folge entsprechende 






nicht 


Message-Port wurde nicht 






gefunden 


gefunden. Stellen Sie sicher, 






(Host 


daB der betreffende externe 






environment 


Host aktiv ist. 






not found) 




14 


10 


Angeforderte 


Es wurde versucht, eine in der 






Bibliothek 


Bibliotheksliste enthaltene 






nicht 


Funktionsbibliothek zu offnen, 






gefunden 


die Bibliothek konnte jedoch 






(Requested 


nicht geoffnet werden. Stellen 






library not 


Sie sicher, daB Name und 






found) 


Version der Bibliothek korrekt 



angegeben wurden, als die 
Bibliothek in die Ressourcen- 
liste aufgenommen wurde. 
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Fehlermeldungen 


Fehler 


Fehler- 
code 


Meldung 


Erlauterung 


15 


10 


Funktion 


Es wurde eine Funktion 






nicht 


gefunden, die weder in einer 






gefunden 


der gegenwartig im Zugriff 






(Function 


befindlichen Bibliotheken 






not found) 


gefunden noch als externes 
Programm lokalisiert werden 
konnte. Stellen Sie sicher, daG 
die entsprechenden 
Funktions-bibliotheken in die 
Biblio-thekenliste 
aufgenommen wurden. 


16 


10 


Funktion gab 


Es wurde eine Funktion auf- 






keinen Wert 


gerufen, die keine Ergebnis- 






zuruck 


zeichenfolge zuruckgab, aber 






(Function did 


auch sonst keinen Fehler 






not return 


meldete. Stellen Sie sicher, 






value) 


daf3 die Funktion korrekt 
programmiert wurde oder 
rufen Sie die Funktion uber 
den Befehl CALL auf. 


17 


10 


Falsche 


Es wurde eine Funktion 






Anzahl an 


aufgerufen, die eine andere 






Argumenten 


Anzahl Argumente erwartet. 






(Wrong 


Dieser Fehler wird generiert, 






number of 


wenn eine integrierte Oder 






arguments) 


externe Funktion mit mehr 



18 



10 



Argumenten aufgerufen wird, 
als das Nachrichtenpaket fur 
die externe Kommunikation 
aufnehmen kann. 

Ungultiges Einer Funktion wurde ein 

Argument fur unpassendes Argument 

Funktion mitgegeben, oder es fehlte ein 

(Invalid erforderliches Argument, 

argument to Uberprufen Sie die erforder- 

function) lichen Argumente der 
betreffenden Funktion. 



Fehlermeldungen 
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Fehler Fehler- 


Meldung 


Erlauterung 


code 






19 10 


Ungultige 


Ein PROCEDURE-Befehl 




PROCE- 


wurde in einem ungultigen 




DURE 


Kontext gegeben. Entweder 




(Invalid 


waren keine internen Funk- 




PROCE- 


tionen aktiv, Oder ein 




DURE) 


PROCEDURE-Befehl war 
zuvor bereits in der aktuellen 
Speicherumgebung gegeben 
worden. 


20 10 


Unerwarte- 


Ein WHEN- oder THEN-Befehl 




tesTHEN 


wurde auBerhalb eines 




Oder WHEN 


gultigen Kontexts aufgerufen. 




(Unexpected 


Der Befehl WHEN ist nur 




THEN or 


innerhalb eines SELECT- 




WHEN) 


Bereichs gultig, THEN muB als 
nachster Befehl auf IF oder 
WHEN folgen. 


21 10 


Unerwarte- 


Ein ELSE- oder OTHERWISE- 




tes ELSE 


Befehl wurde auBerhalb eines 




Oder 


gultigen Kontexts gefunden. 




OTHER- 


Der Befehl OTHERWISE ist 




WISE 


nur innerhalb eines SELECT- 




(Unexpected 


Bereichs gultig, ELSE ist nur 




ELSE or 


als Folge eines THEN-Zweigs 




OTHER- 


innerhalb eines IF-Bereichs 




WISE) 


gultig. 


22 10 


Unerwarte- 


Der Befehl BREAK ist nur 




tes BREAK, 


innerhalb eines DO-Bereichs 




LEAVE Oder 


oder innerhalb einer 




ITERATE 


INTERPRETierten Zeichen- 




(Unexpected 


folge gultig. Die Befehle 




BREAK, 


LEAVE und ITERATE sind nur 




LEAVE or 


innerhalb eines iterativen DO- 




ITERATE) 


Bereichs gultig. 



A-8 



Fehlermeldungen 





Fehler Fehier- 


Meldung 


Erlauterung 


code 






23 10 


Unguttige 


Innerhalb eines SELECT- 




Anweisung in 


Bereichs wurde eine ungultige 




SELECT 


Anweisung entdeckt. Nur die 




(Invalid 


Anweisungen WHEN, THEN 




statement in 


und OTHERWISE sind inner- 




SELECT) 


halb eines SELECT-Bereichs 
gultig, abgesehen von den 
bedingten Anweisungen, die 
auf eine der Klauseln THEN 
Oder OTHERWISE folgen 
konnen. 


24 10 


Fehlendes 


Eine vom Programm erwartete 




Oder mehr- 


THEN-Klausel wurde nicht 




fach yorkom- 


gefunden, oder es wurde ein 




mendes 


weiteres THEN festgestellt, 




THEN 


nachdem bereits eines ausge- 




(Missing or 


fuhrt wurde. 




multiple 






THEN) 




25 10 


Fehlendes 


Keine der WHEN-Klauseln in 




OTHER- 


einem SELECT-Bereich war 




WISE 


erfolgreich, dennoch war keine 




(Missing 


OTHERWISE-Klausel 




OTHER- 


vorhanden. 




WISE) 




26 10 


Fehlendes 


Der Quelltext des Programms 




oder uner- 


war beendet, bevor ein DO- 




wartetes 


oder SELECT-Befehl mit END 




END 


abgeschlosseh war, oder ein 




(Missing or 


END-Befehl wurde auf3erhalb 




unexpected 


eines DO- oder SELECT- 




END) 


Bereichs entdeckt. 



Fehlermeldungen 
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Fehler 


Fehler- 
code 


Meldung 


Erlauterung 


27 


10 


Symbol ohne 


Das in einem END-, ITERATE- 






Entspre- 


oder LEAVE-Befehl angege- 






chung 


bene Symbol entsprach nicht 






(Symbol 


der Indexvariablen des DO- 






mismatch) 


Bereichs. Stellen Sie sicher, 
daf3 die aktiven Schleifen 
korrekt verschachtelt sind. 


28 


10 


Ungultige 


Ein ungultiger DO-Befehl 






DO-Syntax 


wurde aufgerufen. Bei Angabe 






(Invalid DO 


eines Ausdrucks nach TO 






syntax) 


oder BY ist auch ein 



29 



10 



30 



10 



Initialisierungs-ausdruck 
erforderlich. Ein FOR- 
Ausdruck mu(3 zu einem 
ganzzahligen, nicht negativen 
Ergebnis fuhren. 

Unvollstan- Ein IF- oder SELECT-Bereich 

diges IF oder endete, bevor alle dafur erfor- 
SELECT derlichen Anweisungen ge- 

(Incomplete funden werden konnten. Uber- 

IF or prufen Sie, ob die bedingte 

SELECT) An-weisung, die auf eine 

THEN-, ELSE- oder 
OTHERWISE-Klausel folgen 
muB, moglicher-weise fehlt. 

Sprung- Eine Sprungmarke, die in 

marke nicht einem SIGNAL-Befehl ange- 

gefunden geben oder auf die durch 

(Label not einen aktiven Interrupt implizit 

found) verwiesen wurde, konnte im 

Quelltext des Programms 
nicht gefunden werden. 
Sprung-marken, die durch 
einen INTERPRET-Befehl 
oder eine Dialogeingabe 
dynamisch aktiviert wurden, 
werden vom Suchvorgang 
nicht abgedeckt. 
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Fehler 


Fehler- 
code 


Meldung 


Erlauterung 


31 


10 


Symbol 


Ein Token, das kein Symbol 






wurde 


ist, wurde an einer Stelle 






erwartet 


ange-troffen, an der nur ein 






(Symbol 


Symbol-Token zulassig ist. 






expected) 


Auf die Befehle DROP, END, 
LEAVE, ITERATE und UPPER 
darf nur ein Symbol-Token 
folgen. Diese Meldung wird 
auch aus-gegeben, wenn ein 
erforder-liches Symbol fehlt. 


32 


10 


Symbol oder 


Ein ungultiges Token wurde in 






Zeichenfolge 


einem Kontext angetroffen, in 






wurde 


dem nur ein Symbol oder eine 






erwartet 


Zeichenfolge zulassig ist. 



33 



10 



34 



10 



35 



10 



Ungultiges 


Ein Symbol-Token in einer 


Schlussel- 


Befehlsklausel wurde als 


wort 


Schlusselwort identifiziert, war 


(Invalid 


aber im betreffenden Kontext 


keyword) 


ungultig. 


Erfoderliches 


Eine Befehlsklausel erfordert 


Schlussel- 


ein bestimmtes Schlusselwort- 


wort fehlt 


Token, dieses war aber nicht 


(Required 


vorhanden. Diese Meldung 


keyword 


wird ausgegeben, wenn auf 


missing) 


einen Befehl SIGNAL ON kein 




Interrupt-Schlusselwort folgt 




(z. B. SYNTAX). 


Nicht 


Eine scheinbar gultige An- 


zugehorige 


weisung wurde ausgefuhrt, am 


Zeichen 


Ende der Klausel wurden 


(Extraneous 


jedoch zusatzliche Zeichen 


characters) 


festgestellt. 



Fehlermeldungen 
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Fehler 


Fehler- 
code 


Meldung 


Erlauterung 


36 


10 


Schlussel- 


Eine Befehlsklausel enthielt 






wortkonflikt 


zwei Schlusselworter, die sich 






(Keyword 


gegenseitig ausschlieBen, 






conflict) 


oder ein Schlusselwort wurde 
zweimal im gleichen Befehl 
angegeben. 


37 


10 


Ungultige 


Die zu einem ARG-, PARSE- 






Schablone 


oder PULL-Befehl 






(Invalid 


angegebene Schablone war 






template) 


nicht korrekt aufgebaut. 


38 


10 


Ungultige 


Das zu einem TRACE-Befehl 






TRACE- 


oder als Argument zu einer 






Anforderung 


integrierten TRACE()-Funktion 






(Invalid 


angegebene alphabetische 






TRACE 


Schlusselwort war ungultig. 






request) 




39 


10 


Nicht 


Es wurde versucht, eine nicht 






initialisierte 


initialisierte Variable zu 






Variable 


verwenden, wahrend der 






(Uninitialized 


NOVALUE-lnterrupt aktiviert 






variable) 


war. 


40 


10 


Ungultiger 


Es wurde versucht, einem 






Variablen- 


festen Symbol einen Wert 






name 


zuzuordnen. 






(Invalid 








variable 








name) 





A-12 
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Fehler 


Fehler- 
code 


Meldung 


Erlauterung 



41 



10 



42 



10 



43 



10 



44 



10 



Ungultiger Bei der Bewertung eines 

Ausdruck Ausdrucks wurde ein Fehler 

(Invalid festgestellt. Stellen Sie sicher, 

expression) daB zu jedem Operator die 

korrekte Anzahl Operanden 
angegeben wurde, und daB 
keine nicht zugehorigen 
Zeichen im Ausdruck vor- 
kommen. Dieser Fehler wird 
nur in Ausdrucken festgestellt, 
die tatsachlich ausgewertet 
werden. Bei Ausdrucken in 
Klauseln, die ubersprungen 
werden, erfolgt keine Uber- 
prufung. 



Fehlerhafte 


Ein Ausdruck wurde entdeckt, 


Anzahl 


in dem die Anzahl der offnen- 


runder 


den Klammern von der Anzahl 


Klammern 


der schlieBenden Klammern 


(Unbalanced 


abweicht. 


parentheses) 




Verschachte- 


Die Anzahl der Unteraus- 


lungsgrenz- 


drucke innerhalb eines Aus- 


wert uber- 


drucks uberschreitet das 


schritten 


zulassige Maximum. Verein- 


(Nesting limit 


fachen Sie den Ausdruck, 


exceeded) 


indem Sie ihn in zwei oder 




mehr kleinere Ausdrucke 




zerlegen. 


Ungultiges 


Das Ergebnis eines Ausdrucks 


Ergebnis 


war innerhalb seines Kontexts 


eines 


ungultig. Diese Meldung wird 


Ausdrucks 


ausgegeben, wenn ein Inkre- 


(Invalid 


ment oder Grenzwertausdruck 


expression 


in einem DO-Befehl zu einem 


result) 


nicht numerischen Ergebnis 




fuhrt 



Fehlermeldungen 
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Fehler 


Fehler- 
code 


Meldung 


Erlauterung 


45 


10 


Ausdruck 


Ein Ausdruck wurde in einem 






erforderlich 


Kontext weggelassen, in dem 






(Expression 


er erforderlich gewesen ware. 






required) 


Auf den Befehl SIGNAL muf3 
z. B. ein Ausdruck folgen, es 
sei denn, es folgt eines der 
Schlusselworter ON oder 
OFF. 


46 


10 


Boolescher 


Als Ergebnis eines Ausdrucks 






Wert ist nicht 


wurde ein boolescher Wert 






Oder 1 


erwartet, die Auswertung 






(Boolean 


ergab aber etwas anderes als 






value not 


oder 1 . 






or1) 




47 


10 


Fehlerhafte 


Ein nicht numerischer 






arithmeti- 


Operand wurde in einer 






sche Konver- 


Operation ver-wendet, die 






sion 


numerische Operanden 






(Arithmetic 


verlangt. Diese Meldung wird 






conversion 


auch im Falle einer ungultigen 






error) 


hexadezi-malen oder binaren 
Zeichen-folge generiert. 


48 


10 


Ungultiger 


Ein Operand war fur die 






Operand 


beabsichtigte Operation nicht 






(Invalid 


gultig. Diese Meldung wird 






operand) 


generiert, wenn versucht 



wurde, durch zu dividieren 
odereinen Bruch als 
Exponen-ten in einer 
Potenzierungs-operation zu 
verwenden. 



Anhang B 

Kommandohilfsprogramme 



ARexx bietet eine Reihe von Kommandohilfsprogrammen mit 
verschiedenen Steuerfunktionen. Diese Programme stehen im 
Verzeichnis REXXC. Dabei handelt es sich um ausfuhrbare Pro- 
gramme, die von der Shell aus aufgerufen werden konnen und nur 
dann relevant sind, wenn der residente ARexx-Prozefi aktiv ist. 



HI (Halt-Interrupt) HI 

Setzt das globale Halt-Kennzeichen, das bewirkt, daB alle laufenden 
ARexx-Programme eine externe Halt-Anforderung empfangen. 
Jedes Programm wird augenblicklich verlassen, es sei denn, fur das 
Programm ist der HALT-Interrupt aktiviert. Das Halt-Kennzeichen 
bleibt nicht gesetzt, sondern wird automatisch geloscht, nachdem 
alle laufenden Programme die Halt-Anforderung erhalten haben. 



RX (Rexx eXecute) RX Name [Argumente] 

Startet ein ARexx-Programm. Falls der angegebene Name eine 
explizite Pfadangabe enthalt, wird nur in diesem Verzeichnis nach 
dem Programm gesucht. Andernfalls werden das aktuelle Ver- 
zeichniss sowie REXX: nach einem Programm des angegebenen 
Namens durchsucht. Die wahlfrei anzugebende Argumentzeichen- 
folge wird an das Programm weitergeleitet. 



B-2 Kommandohilfsprogramme 



RXSET RXSET [Name [[=] Wert]] 

Ftigt ein (Name,Wert)-Paar in die Clip-Liste ein. Bei Namens- 
zeichenfolgen wird vorausgesetzt, daB sie GroB- und Klein- 
schreibung enthalten. Wenn ein Paar dieses Namens bereits 
existiert, wird sein Wert durch die aktuelle Zeichenfolge ersetzt. 
Wird ein Name ohne Wertzeichenfolge angegeben, so wird der 
Eintrag aus der Clip-Liste entfernt. Wird RXSET ohne Argumente 
aufgerufen, werden alle (Name, Wertj-Paare aus der Clip-Liste auf- 
gelistet. 



RXC (REXX Close) RXC 

SchlieBt den residenten ProzeB. Der allgemein zugangliche "REXX"- 
Port wird unverzuglich geschlossen. Der residente ProzeB wird 
verlassen, sobald das letzte ARexx-Programm abgeschlossen ist. 
Nach einer solchen AbschluBanforderung konnen keine weiteren 
Programme gestartet werden. 



TCC (TraCe Close) TCC 

SchlieBt die globale Ablaufverfolgungskonsole, sobald sie von 
keinem aktiven Programm mehr benutzt wird. Alle an der Konsole 
anstehenden Leseanforderungen mussen beantwortet worden sein, 
bevor sie geschlossen werden kann. 



TCO (TraCe Open) TCO 

Offnet die globale Ablaufverfolgungskonsole. Die Ausgabedaten der 
Ablaufverfolgung aller aktiven Programme werden automatisch an 
die neue Konsole umgeleitet. Der Benutzer kann GroBe und 
Position des Konsolenfensters verandern, und er kann das Kon- 
solenfenster mit dem Kommando TCC schlieBen. 



Kommandohilfsprogramme B-3 



TE (Trace End) TE 

Loscht das Kennzeichen fur globale Ablaufverfolgung. Damit wird 
der Ablaufverfolgungsmodus fur alle aktiven ARexx- Programme auf 
OFF gesetzt. 



TS (Trace Start) TS 

Startet die interaktive Ablaufverfolgung, indem das externe Ablauf- 
verfolgungskennzeichen gesetzt wird. Damit werden alle aktiven 
ARexx- Pro gramme in den interaktiven Ablaufverfolgungsmodus 
gebracht. Die Programme beginnen, Ausgabedaten zur Ablaufver- 
folgung zu erzeugen, und pausieren nach der nachsten Anweisung. 
Dieser Befehl ist mitzlich, wenn Sie die Kontrolle iiber Programme 
wiedererlangen wollen, die sich in Endlosschleifen befinden oder 
andere ungewohnliche Fehlersymptome zeigen. Das Ablaufver- 
folgungskennzeichen bleibt solange gesetzt, bis es mit dem 
Kommando TE geloscht wird, d. h. spater aufgerufene Programme 
werden ebenfalls im interaktiven Ablaufverfolgungsmodus ausge- 
fiihrt. 



WaitForPort WaitForPort [Name des Ports] 

WaitForPort wartet 10 Sekunden, bis der angegebene Port bereit- 
gestellt wird. Der Rtickgabewert bedeutet, daB der Port gefunden 
wurde. Der Rtickgabewert 5 zeigt an, daB die Anwendung gegen- 
wartig nicht lauft oder daB der Port nicht existiert. Bei Port-Namen 
wird zwischen GroB- und Kleinschreibung unterschieden. Beispiel: 

WaitForPort ED_1 

Wa it For Port MeinPort 



Glossar 



In diesem Glossar finden Sie Definitionen von Fachbegriffen, die im 
ARexx-Handbuch verwendet werden. 

Ablaufverfolgung 

Zeigt die Zeilen eines ARexx-Programms an, wahrend dieses 
ausgefuhrt wird. Auf dieses Weise lassen sich Fehler exakt 
lokalisieren. 

Adresse 

Eine Kennummer, die jedem Datenbyte in einem 
Computerspeicher und jedem Sektor auf einer Festplatte oder 
Diskette zugeordnet wird. 

Anweisung 

Eine Zuweisungs-, Befehls- oder Kommandoklausel. 

Argument 

Eine Zusatzinformation zu einem Befehl oder einer Funktion. 
Das Argument bestimmt die auszufuhrende Aktion. 

Ausdruck 

Eine Gruppe auszuwertender Tokens. Ausdrlicke bestehen aus 
Zeichenfolgen, Symbolen, Operatoren und runden Klammern. 

Befehl 

Eine Klausel, die mit einem bestimmten Schliisselwort beginnt 
und ARexx zur Ausfuhrung einer Aktion auffordert. 

Begrenzungszeichen 

Ein Zeichen, das Anfang und Ende einer Zeichenfolge markiert. 
ARexx-Begrenzungszeichen sind das einfache (') und das 
doppelte Anfuhrungszeichen ("). 
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Bibliotheksliste 

Eine interne, von ARexx verwaltete Liste aller gegenwartig 
verfugbaren Funktionsbibliotheken und Funktions-Hosts. 
Anwendungen konnen bei Bedarf Funktionsbibliotheken 
hinzufugen oder entfernen. 

Boolesch 

Werte mit zwei moglichen Zustanden: (falsch) oder 1 (wahr). 

Clip-Liste 

Ein Zwischenspeicher, der fur die Kommunikation zwischen 
Tasks gebraucht wird. Mit der Funktion SETCLIPO konnen 
Begriffspaare (Name, Wert) in die Clip-Liste aufgenommen 
werden. 

Einfaches Symbol 

Ein Token, das nicht mit einer Ziffer beginnt und keine Punkte 
enthalt. 

Fehlersuche (Debugging) 

Das Lokalisieren und Beheben von Programmfehlern. 

Festes Symbol 

Ein Token, das mit einer Ziffer oder einem Punkt beginnt. 

Funktion 

Eine Gruppe von Anweisungen, die als zusammengehoriger 
Block ausgefuhrt werden kann. Funktioneh ermbglichen den 
Aufbau komplexer Programme aus kleineren Modulen. 

Funktions-Host 

Eine externe Anwendung mit ARexx-Port. Der Name eines 
Funktions-Hosts ist der Name des allgemein zuganglichen 
Message-Ports des Programms. 

Funktionsbibliotheken 

Eine Sammlung einer oder mehrerer Funktionen, die als 
gemeinsam benutzbare Amiga-Bibliothek aufgebaut ist. Eine 
Funktionsbibliothek muB einen Bibliotheksnamen, eine 
Suchprioritat, einen Offset fur die Einstiegsposition und eine 
Versionsnummer enthalten. 
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Globale Umgebung 

Die festen Komponenten eines ARexx-Programms. Dazu 
gehoren der Quellencode des Programms, statische 
Datenzeichenfolgen und Argumentzeichenfolgen. 

Host-Adresse 

Innerhalb und auBerhalb einer Anwendung ist die Host-Adresse 
der Name des Message-Ports, an den ARexx-Kommandos 
gesendet werden konnen. 

Interrupts 

Interne Kennzeichen in ARexx, mit deren Hilfe ein Programm 
Fehler feststellen und die Steuerung in Fallen beibehalten 
kann, in denen das Programm ohne solche Kennzeichen 
abgebrochen wiirde. Interrupts werden normalerweise iiber den 
Befehl SIGNAL: gesteuert. 

Iteration 

Wiederholen eines Programmabschnitts. 

Klausel 

Die kleinste ausfiihrbare Einheit einer Programmiersprache. 

Kommandoklausel 

Ein ARexx-Ausdruck, in welchem das Ergebnis als Kommando 
an eine externe Anwendung ausgegeben wird. 

Kommandoschnittstelle 

Ein Message-Port, iiber den ARexx-Kommandos an kompatible 
Anwendungen ausgegeben werden. 

Kommentar 

Eine Gruppe von Zeichen, die zwischen den Symbolen /*....*/ 
steht. Jedes ARexx-Programm beginnt mit einem Kommentar. 

Makro 

Andere Bezeichnung fur ein ARexx-Programm. 

Markierung 

Ein Token, das Anfang und Ende einer Analysezeichenfolge 
bestimmt. 
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Message-Port 

Eine Schnittstelle in einer Amiga-Anwendung, liber die das 
Programm mit einem ARexx-Programm kommunizieren kann. 

Nullklausel 

Eine Leerzeile oder Kommentarzeile. 

Numerische Genauigkeit 

Die Anzahl der Dezimalstellen in einem arithmetischen 
Ergebnis. Je weniger Dezimalstellen, desto ungenauer das 
Ergebnis. 

Operatoren 

Ein Zeichen wie (+), (-) oder ( I ), das bei arithmetischen 
Verkettungen, Vergleichen oder logischen Operationen 
verwendet wird. 

Prozefikommunikation 

Datenaustausch zwischen Anwendungen. 

RexxMast 

Das Programm, das als Interpreter fur ARexx-Programme 
eingesetzt wird. 

Ruckgabewert 

Der Schweregrad eines Fehlers. Diese Zahl (5, 10 oder 20) wird 
angezeigt, wenn es in einem ARexx-Programm zu einem Fehler 
kommt. 

Schablone 

Eine Gruppe von Tokens, die angibt, welche Variablen in einer 
Syntaxanalyseoperation zu verwenden sind. Die Schablone 
bestimmt auch die Art und Weise, in der die Werte festgelegt 
werden. 

Speicherumgebung 

Die variablen Komponenten eines ARexx-Programms. Dazu 
gehoren die Symboltabelle, numerische Optionen, 
Ablaufverfolgungsoptionen und Host-AdreBzeichenfolgen. 

Sprungmarke 

Ein Symbol-Token, gefolgt von einem Doppelpunkt (:). 
Sprungmarken bezeichnen bestimmte Positionen in einem 
Programm. 
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Stammsymbol 

Ein Token mit einem Punkt am Ende seines Namens. 
Stammsymbole dienen zur Initialisierung zusammengesetzter 
Symbole. 

Symbol 

Eine beliebige Gruppe in der die alphanumerischen Zeichen a-z, 
A-Z, 0-9, Punkt (.), Ausrufezeichen (!), Fragezeichen (?), 
Dollarzeichen ($) und Unterstreichungszeichen (_) vorkommen 
konnen. 

Symboltabelle 

Eine interne, von ARexx erstellte Tabelle, in der 
Wertzeichenfolgen gespeichert werden, die den Variablen in 
einem Programm zugeordnet wurden. 

Syntaxanalyse 

Das Zerlegen einer Zeichenfolge in kleinere Einheiten. 

Token 

Die kleinsten Einheiten der Programmiersprache ARexx. 

Tokenisierung 

Das Zerlegen einer Anweisung in ihre einzelnen Tokens. 

Variable 

Ein Symbol, dem ein Wert zugeordnet werden kann. 

Verkettung 

Der Vorgang der Verkniipfung (Aneinanderreihung) zweier 
Zeichenfolgen. 

Zeichenfolge 

Eine Gruppe von Zeichen, die mit einem Begrenzungszeichen 
beginnt und endet (einfache oder doppelte Anfiihrungszeichen). 
Der Wert einer Zeichenfolge ist die Zeichenfolge selbst. 

Ziel 

Ein normalerweise variables Symbol, das im Verlauf einer 
Syntaxanalyse einem Wert zugeordnet wird. 
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Zuordnungsklausel 

Ein variables Symbol (einfach, zusammengesetzt oder 
Stammsymbol), auf das der Operator = folgt. In einer 
Zuordnungsklausel, werden die Tokens rechts vom 
Gleichheitszeichen ausgewertet und das Resultat dem variablen 
Symbol zugeordnet. 

Zusammengesetztes Symbol 

Ein Token, in dem alphanumerische Zeichen, die Zeichen ., !, ?, 
$ und _ sowie ein oder mehrere Punkte innerhalb eines Namens 
vorkommen konnen. Zusammengesetzte Symbole besitzen die 
Struktur Stamm.nl.n2...nk. 



Index 



B 



ABBREV(), 5-9 


B2C(), 5-11-5-12 


Ablaufverfolgung, 1-4, 5-36, 6-1 


Bedingte Anweisungen, 4-9, 4-10, 


Anzeigeformatierung, 6-3 


4-12 


Ausgabe, 6-3 


bedingte Anweisungen, 4-22, 4-24 


Fehlersuche, 1-4 


Befehle, 2-6, 2-8, 2-10, 4-1 


globale 


Befehlsklauseln, 3-13 


Ablaufverfolgungskonsole, 6-4, 


Befehlsklauseln, 3-12 


interaktiv, 6-2, 6-5 


Begrenzungszeichen, 3-6 


Interrupts, 6-8 


Bibliotheken 


Optionen, 3-23, 5-2,6-1, 6-5, 


Funktionsbibliotheken, 5-4 


6-7 


gemeinsam benutzt, 5-4 


ABS(), 5-9-5-10 


Bibliotheksliste, 5-4 


ADDLIB(), 5-10 


Bibliotheken hinzufugen, 5-10 


ADDRESS, 3-16, 4-3-4-4, 4-22 


Eintrage entfernen, 5-29-5-30 


ADDRESS(), 3-17, 4-3, 5-10-5-11 


uberpriifen, 5-31 


ALLOCMEM(), 5-22, 5-44-5-45 


BITANDQ.5-12 


ARG, 2-10, 4-4,4-19, 6-2, 7-1 


BITCHG(), 5-12 


ARG(), 5-11 


BITCLR(), 5-12 


Argumentzeichenfolgen, 2-9, 3-23, 


BITCOMPO, 5-12-5-13 


4-4, 7-1 


BITOR(), 5-13 


Aufrufen Funktionen, 4-5 


BITSET(), 5-13 


Ausdrucke, 3-1, 3-14 


BITTST(), 5-13-5-14 


Ausgabe anzeigen, 4-22 


BITXOR(), 5-14 


Ausgabedatenstrom, 6-4 


BREAK, 4-5, 4-11 


Ausgabestrom, 3-22 





lndex-2 



C2B(), 5-14 

C2D(), 5-14 

C2X(), 5-14-5-15 

CALL, 4-2, 4-5-4-6, 5-2 

CENTER(), 5-15 

Clip List 

durchsuchen, 5-22 
uberprufen, 5-31 

Clip-Liste, 5-7 

Werte hinzufugen, 5-31 

CLOSE(), 5-15 

CLOSEPORT() f 5-45 

COMPAREO, 5-15 

COMPRESS(), 5-15-5-16 

COPIESO, 5-16 



D2C(), 5-16 

D2X(), 5-16 

DATATYPE(), 5-17-5-18 

DATE(), 5-16-5-17 

DELSTRO, 5-18 

DELWORD(), 5-19 

DIGITSO, 5-19 

DO, 2-7, 4-5, 4-6-4-8, 4-9, 4-11, 

4-12,6-5 

DROP, 4-8 



EOF(), 5-19 

ERRORTEXT(), 5-19 

EXISTS(), 5-20 

EXIT, 2-10, 4-9-4-10, 4-21 

EXPORT(), 5-20 

extern 

Ablaufverfolgungskenn- 

zeichen, 6-7 

Datei 

offnen, 5-25-5-26 

Dateien, 5-4 

Funktionsbibliotheken, 5-4 

Umgebung, 3-22 



Fehlerbehandlung, 6-6 
Fehlersuche 

Ablaufverfolgung, 1-4, 2-10, 

6-1 
Feste Symbole, 3-14, 7-3 
FIND(), 5-21 
FORM(), 5-20 
FREEMEM(), 5-45-5-46 
FREESPACE(), 5-21 
Funktionen, 2-9, 2-10, 5-1 

aufrufen, 4-5, 5-1 

integriert, 5-6 

integrierte Funktionen, 5-3 

intern, 3-23, 5-2, 5-6 
Funktions-Hosts, 5-5, 5-6 
Funktionsbibliothekek, 5-6 
Funktionsbibliotheken, 1-4, 5-5 
FUZZQ, 5-21 



ECHO, 4-8 

Einfache Symbole, 3-3, 3-23 

Eingabedatenstrom, 3-21, 6-4 

Eingabestrom, 3-22 

ELSE, 4-8-4-9 

END, 4-6,4-9, 4-11,4-22 



lndex-3 



GETARG(), 5-46 
GETCLIPO, 5-8, 5-22 
GETPKT(), 5-46-5-47 
GETSPACE(), 5-22 
global 

Ablaufverfolgungskonsole, 6-4 

Umgebung, 3-23 



H 

HALT, 4-23 
HASH(), 5-22 
Host Adresse, 5-11 
Host-Adresse, 3-16, 3-23, 4-3, 
5-11 



IF, 2-8, 2-9 

IMPORT(), 5-20, 5-23 
INDEX(), 5-23, 7-1 
Initialisierungsausdruck 

Initialisierer, 4-6 
INSERTO, 5-23 
integrierte Funktionen, 5-3, 5-6 
Interaktive Ablaufverfolgung, 6-2, 
6-5 
Intern 

Interrupts, 6-1 

Standardwerte, 4-14 
intern 

Funktionen, 5-2, 5-6 

Interrupts, 6-6 

Umgebung, 3-23 
interne 

Unterbrechungskennzeichen, 4-22 
INTERPRET, 4-5, 4-10-4-11,6-5 



interrupt flags, 6-7 
Interrupt-Kennzeichen, 6-6, 6-9 
Interrupts, 6-8 
ITERATE, 4-11, 4-12 



K 



Klammern, 3-14 

Klauseln, 3-1,3-11 
Befehl, 3-12,3-13 
Fortsetzung von, 3-12 
Kommando, 3-12, 3-14, 6-2, 
6-5 

Null, 3-12 

Sprungmarke, 4-1 1 , 5-2, 6-2 
Sprungmarkenklauseln, 3-13 
Zuweisung, 3-13 

Kommando 

Klauseln, 3-12, 3-14, 6-2 
Schnittstelle, 3-1,3-16 
Shell, 3-21,4-20 

Kommandoklauseln, 6-5 

Kommentar, 2-5, 2-7 

Kommentare, 2-7, 3-2, 3-12 



LASTPOS(), 5-24 
LEAVE, 4-5, 4-11 
Leerzeichen, 3-7 
LEFT(), 5-24 
LENGTH(), 5-24 
LINESQ, 5-25 



lndex-4 



M 



Makros, 3-19 
Marken, 7-1,7-2 

Position, 7-7 
MAX(), 5-25 

Mehrere Schablonen, 4-16, 7-3, 
7-7 

mehrere Schablonen, 4-17, 4-18 
Message-Ports 

erstellen, 5-47 

schlieBen, 5-45 

uberprufen, 5-46-5-47 
MIN(), 5-25 
Multitasking, 1-2 
Muster 

Marke, 7-3, 7-5 

Marken, 7-2, 7-3 

suchen, 5-26 

Syntaxanalyse, 7-6 



N 



NOP, 4-9, 4-12 
Null-Klauseln, 3-12 
NUMERIC, 3-7, 4-12-4-13, 5-2 
Numeric Digits, 3-7, 3-8, 3-9, 4-13, 
5-19 

technische Schreibweise, 4-13 

wissenschaftliche 

Schreibweise, 4-13 



OPEN(), 5-25-5-26 
OPENPORTO, 5-47 



Operatoren, 3-2, 3-6, 3-14, 7-3 
arithmetisch, 3-6, 3-7 
logisch, 3-10 
logische, 3-7 
Vergieich, 3-7, 3-9 
Verkettung, 3-7, 3-8 

OPTIONS, 5-3, 6-7 

OTHERWISE, 4-14-4-15 

OVERLAY(), 5-26 



PARSE, 6-2, 7-1 
POS(), 5-26 
Positionsmarken, 7-7 
PRAGMAQ, 5-27-5-28 
PROCEDURE, 4-18-4-19, 5-3 
Programme aufrufen, 2-7 
ProzeBkommunikation, 1-2, 1-3 
PULL, 2-7, 2-11, 4-19-4-20, 6-2, 
7-1 
PUSH, 4-20 



RANDOM(), 5-28 
RANDU(), 5-28-5-29 
RC, Variable, 3-21 
RC-Variable, 6-10 
READCHO, 5-29 
READLNO, 5-29 
REMLIBO, 5-29-5-30 
REPLY(), 5-47 
RESULT, Variable, 4-5 
RETURN, 2-10, 4-21-4-22, 5-3 
REVERSEQ, 5-30 
REXX, 2-3 
REXX:, 2-3 
RexxMast, 2-1,2-5, 3-22 



lndex-5 



REXXSupport.Bibliothek, 5-43- 

5-49 

REXXSupport.library 

offnen, 5-44 
RIGHTQ, 5-30 
Ruckgabecodes, 3-21 
Ruckgabewerte, 4-14, 6-2 
Runde Klammern, 7-3 
RX, 2-3, 2-4 



SAY, 2-6, 2-7, 2-8, 2-10, 4-8, 4-22 
Schablone, 4-4, 4-15, 4-20, 7-1 

mehrere, 4-16, 4-17, 4-18, 

7-3, 7-7 

Objekte, 7-1, 7-3 
Schleife, 2-8,2-11 
Schleifen, 2-8, 2-10,4-6 
Schlusselworter, 4-1 , 4-2 
SEEK(), 5-30 
SELECT, 4-9, 4-22, 6-5 
SETCLIP(), 5-31 
SHELL, 4-22 
SHOW(), 5-11,5-31-5-32 
SHOWDIRO, 5-47-5-48 
SHOWLIST(), 5-48-5-49 
SIGL Variable, 4-24 
SIGL- Variable, 6-10 
SIGN(), 5-32 

SIGNAL, 4-22-4-24, 5-3, 6-7, 6-8 
Signalbedingungen, 4-23 
SOURCELINE(), 5-32 
SPACE(), 5-32 
Speicher 

Blocke freigeben, 5-45-5-46 

Blocke reservieren, 5-22, 5- 

44-5-45 

Umgebung, 3-23 
Speicherumgebung, 3-23, 4-3, 5-2, 
5-6 



Sprungmarkenklauseln, 3-13, 
4-11,5-2, 6-2 

Stammsymbole, 3-3, 3-23, 4-19 
STATEF(), 5-49 
STDERR, 4-16, 6-3, 6-4 
STDIN, 4-20, 4-21 
STDOUT, 6-4 
STORAGE(), 5-20, 5-33 
STRIP(), 5-33-5-34 
SUBSTR(), 5-34, 7-1 
SUBWORD(), 5-34 
Suchposition, 7-1, 7-2, 7-4 
SYMBOL(), 5-34-5-35 
Symbole, 2-6, 2-8, 3-2, 3-3, 3-14, 
7-3 

einfach, 3-3, 3-23 

test, 3-14, 7-3 

Stamm, 3-3, 3-23,4-19 

zusammengesetzt, 3-3, 3-23, 

4-8,4-19 
Symboltabelle, 3-15, 3-23, 4-19, 
5-3 

SYNTAX, 6-8 
Syntaxanalyse, 7-1 

durch Tokenisierung, 7-2, 7-5 

Eingabequellen, 4-16 

Marke, 7-1,7-2 

mehrere Schablonen, 7-3, 7-7 

nach Mustern, 7-6 

Schablonen, 7-1 

Suchvorgang, 7-4 

Ziel, 7-1 

Ziele, 7-1,7-2, 7-5 



TCC, 6-4 

TCO, 6-4 

TE, 6-7 

technische Schreibweise, 4-13 

Testhilfe 

Ablaufverfolgung, 6-1 



lndex-6 



TIME(), 5-35-5-36 
Token, 3-1, 3-2 
Tokenisierung, 3-23, 7-5 
TRACE, 2-10, 2-11,6-3 
TRACE(), 5-36, 6-3 
TRANSLATED 5-36 
TRIM(), 5-36 
TRUNCO, 5-37 
TS, 6-7 



W 



u 



Umgebung, 3-22 

externe Umgebung, 3-22 
global, 3-23 

interne Umgebung, 3-23 
Speicher, 3-23, 4-3, 5-2, 5-6 
Speicher-, 3-23 

Umwandeln 

Binarziffern, 5-11-5-12 
dezimal in hexadezimal, 
hexadezimal in dezimal, 
Hexadezimalziffern, 5-39 
in Dezimalwert, 5-14 
in Hexadezimalwert, 5-14- 
5-15 
Zeicherji S-14 

Unterbrechungsk^nnzeichen, 4-22, 

5-3 

UPPER(), 5-37 



5-16 
5-39 



V 



VALUE(), 5-37 

Variablen, 2-7, 3-3, 3-7, 3-23, 

4-15,4-19,7-1 

Rucksetzen der Werte, 4-8 
Variablenwerte, 3-23 
VERIFY(), 5-37-5-38 



WAITPKT(), 5-49 
WHEN, 4-24 

Wissenschaftliche Schreibweise, 
4-13 

WORD(), 5-38 
WORDINDEXO, 5-38 
WORDLENGTH(), 5-38 
WORDS(), 5-38 
WRITECHO, 5-38 
WRITELN(),5-39 



X2C(), 5-39 
X2D(), 5-39 
XRANGEQ, 5-39 



Zeichenfolge 

umkehren, 5-30 
Zeichenfolgen, 2-6, 3-2, 3-6, 3-12, 
3-14,7-3 

Leerzeichen entfernen, 

5-34 

Syntaxanalyse, 4-15 

vergleichen, 5-12-5-13, 
Ziele, 7-1,7-2, 7-5 
Zufallszahlen, 5-28-5-29 
Zusammengesetzte Symbole, 3-3, 
3-23, 4-8 

zusammengesetzte Symbole, 4-19 
Zuweisungsklauseln, 3-13 



5-33- 



5-15 



Notizen 



Notizen 



Notizen 



Notizen 



HP • ■■ •• *%■&. W~ & . . :.#*,? 






^*^^ 






L- ■j?-4k;-^ *-^*\m- -#i%^.*^ ' '■■-■■ 



